Computer Science (intelligence Central)

Discussion in 'Taylor's Tittle-Tattle - General Banter' started by SkylaRose, Apr 25, 2023.

  1. Keighley

    Keighley First Team

    Should ‘of’ worked if you used the grammar checker. :D

    Oxford University Press: impressive!
     
    SkylaRose likes this.
  2. Keighley

    Keighley First Team

    Makes me wonder: are we the only two book authors on the forum? @Ilkley? @Bwood_Horn?

    EDIT: actually, I think @EnjoytheGame is another.
     
  3. SkylaRose

    SkylaRose Administrator Staff Member

    That's a good point actually. We should of teamed up and written a text book on how to run a football club and given it to Gino for Christmas. Could of signed the inside cover with quotes from the forum members about how he's done these past five/six years.

    I'll have to look out for their books then. :)
     
    Keighley likes this.
  4. Bwood_Horn

    Bwood_Horn Squad Player

    No 'full' books. A book chapter, not enough papers (but OKish journals) and far too many reports for industrial clients. I'm out of the lab/academia now and putting out a report every three weeks for my new taskmasters.
     
    Keighley likes this.
  5. Bwood_Horn

    Bwood_Horn Squad Player

    Otter, GarbeliaHornet and SkylaRose like this.
  6. SkylaRose

    SkylaRose Administrator Staff Member

    I pondered that but when I took that away Word flagged it as incorrect. I suppose because it's a wordy title the assumption is it forms a sentence (which is what it is) hence why the full stop is necessary. But I do get your angle as well. I think it's probably correct either way, it just depends on how you read it.
     
  7. The undeniable truth

    The undeniable truth First Team Captain

  8. SkylaRose

    SkylaRose Administrator Staff Member

    This is what the working code will look like on the pages. Again, early prototypes here but I like the highlight background, stands out from the standard white. Using 'Consolas' as the font type makes it look more PC :p

    upload_2024-3-26_23-31-41.png
     
  9. Ilkley

    Ilkley Formerly known as An Ilkley Orn Baht 'at

    Looks good, but I would check with someone who’s red/green colour blind whether the green is still clearly visible.
     
  10. Otter

    Otter Gambling industry insider

    It looks good with the image however I would change two things, the font of "Ada 2021" doesn't fit with everything else. Also the strapline is a bit too wordy.
     
  11. Otter

    Otter Gambling industry insider

    The code example couldn't be clearer, keywords in blue, comments in dark green and the rest in black using a fixed width font. I assume that as this looks like a first "Hello world (Ada)" example and later examples have fewer comments, everyone has their different styles when it comes to comments, when I worked at Siemens they insisted that every line had a comment (tedious), my last two employments say that well written code and good nomenclature for functions, classes and variables means that comments then can be kept to a minimum and not clutter up the code.

    It depends upon what your target audience is, is this book for someone who's never coded before, or an experienced coder who wants to branch into another language? Then I assume that the book is (will be) written accordingly.
     
  12. SkylaRose

    SkylaRose Administrator Staff Member

    I agree. Having one in colour and one in black and white print is always an option going forward. Black and white is the general rule, if they do well enough than a colour print can be put forward later on.
     
  13. SkylaRose

    SkylaRose Administrator Staff Member

    Reason I chose red for and blue was to make the name of the language stand out from the book theme. 2021 is the current standard version of the language and I wanted that to stand out with the language name. I can always change the colours to blend more. I guess with the strapline I wanted to make sure people knew the target audience (beginners) before the even opened the book up.

    Yes the code would be the very first Ada program a beginner would write. In the actual text, each statement would be discussed in more detail so people understand what they mean and how they operate. Comments are generally always pretty heavy going on an initial program but further along most of the programs only have comments at the top and before complex pieces of logic. I think you make a good point though, it's always better to suspend your usage of comments in any program. I've seen some actual video game code with comments splashed all over it. I've always had a personal rule of thumb to only comment if I personally might need prompting what something does when I go back and read it. :)
     
    Otter likes this.
  14. SkylaRose

    SkylaRose Administrator Staff Member

    So I've been working on my cover art for my text book and I decided to ditch the other one as it was too "noisy". I've come up with a much cleaner version. With a lighter font and background.
    Lol the forum background is slightly darker than the cover image colour :p Didn't expect that! Well, the main details are still visible at least so you can guess the colour that I have gone with. Thoughts?


    upload_2024-5-8_13-53-44.png
     
  15. K9 Hornet

    K9 Hornet Border Collie Dog

    Looks like Ada and 2021 are in different fonts.
    Also (and I know nothing about Ada, so sorry if I've missed something), but looked it up in Wikipedia and couldn't see a 2021 version?

    Year Informal name ANSI Standard ISO/IEC Standard
    1980 Ada MIL-STD 1815 —
    1983 Ada 83/87 MIL-STD 1815A 8652:1987
    1995 Ada 95 — 8652:1995
    2007 Ada 2005 — 8652:1995/Amd 1:2007
    2012 Ada 2012 — 8652:2012
    2023 Ada 2022 — 8652:2023
     
  16. UEA_Hornet

    UEA_Hornet First Team Captain

    Out of interest do you really have to come up with your own cover art? Or is this something you send to the OUP as a concept and they work up into a finished version?
     
  17. SkylaRose

    SkylaRose Administrator Staff Member

    I did that so the version and the language name stand out from each other.

    Correct, it is 2022 but the version of the text book I am writing uses aspects from 2012 and some of them pre-date the newer standard. It's done with other languages as well. C++ for example has books on versions that are before the current standard. 2021 was the concept year of the new standard before the ISO standardized it in 2022.

    Correct. I send the concept and they can modify it (they send me information to get my approval on any major changes). It's not scheduled for release until late September 2025 and the new Ada standard takes about ten or so years to release, so any code I've written for the book is still valid for a long time and even after that date. I've worked with OUP before and they are very professional.
     
    UEA_Hornet likes this.
  18. SkylaRose

    SkylaRose Administrator Staff Member

    Have been sent the first sample of what a page of my book will look like by OUP. I quite like it myself. This is the black and white version of the book to enable colourblind readers to understand it. As I'm the author it is always encouraging to get any early feedback on possible changes from a reader. Would you consider this sample adequate and readable with the layout and format style of the source code?

    upload_2024-6-1_19-2-5.png
     
  19. Arakel

    Arakel First Team

    Looks good - the formatting makes it not too dense and the codeblock is well laid out and easy to navigate

    One nitpick I have is the use of italics to indicate important descriptors, like "record", "package", "namespace". I think making these stand out somehow is great, but italics aren't super easy to recognize, especially when scan reading. My personal preference is bold (although I see you've used it for something else below so that might not be workable).

    Minor nitpick really.
     
  20. UEA_Hornet

    UEA_Hornet First Team Captain

    Italics (and bold) are not very dyslexia friendly. At least that's the latest thing at my workplace and we routinely publish reports which go into the public domain.
     
  21. SkylaRose

    SkylaRose Administrator Staff Member

    Yes I understand the italics issue. I would of used bold font on them but the Ada language keywords need to fully standout in the sample code. One other option might be putting them in quotations perhaps? Something like "record" and "package". That could be an alternative option.

    That's really interesting, I've never heard of that before and it's excellent that companies are working hard to help people with difficulties. It could well be an issue as the final cut off date for the printing gets nearer so it is something I will keep in mind and mention it to OUP via email. :)
     
  22. UEA_Hornet

    UEA_Hornet First Team Captain

    Sorry, it was italics and underlining that can cause issues. Bold is suggested as an alternative:

    https://cdn.bdadyslexia.org.uk/uplo...e-guide/BDA-Style-Guide-2023.pdf?v=1680514568
     
    Arakel and SkylaRose like this.
  23. Arakel

    Arakel First Team

    UEA_Hornet likes this.
  24. K9 Hornet

    K9 Hornet Border Collie Dog

    Looks readable Skyla. Just one comment on Ada's tip. .ads is a "support" file, not an "support" file
     
  25. hornmeister

    hornmeister Tired

    As an aside why is dyslexia such a hard word to spell. Someone not being very pc there.
    It's like having steps to a wheelchair shop
     
  26. The undeniable truth

    The undeniable truth First Team Captain

    No spoiler but I'm guessing that Ada turns out to be the killer ?
    I presume when complete you will send a copy to @Keighley who will immediately do a word search for the word "of" so he can check how many should of been "have" ?
     
    Keighley likes this.
  27. SkylaRose

    SkylaRose Administrator Staff Member

    Lol good idea. I guess I could email him the final draft and he can double check OUP work on proof reading. :)
     
  28. hornmeister

    hornmeister Tired

  29. SkylaRose

    SkylaRose Administrator Staff Member

    Makes me want to dig out my old Amiga 1200 and have a little cry. They were the medium for many years and served their purpose well. I remember installing Visual Studio 6.0 back in the late 1990's. Six floppy discs. Time has moved on, even software on CD is becoming more and more obsolete. Digital is taking over which was to be expected, the download speeds of the modern Internet are so much faster than the reads of even the best optical drive.

    We will always have the memories.
     
    Otter likes this.
  30. hornmeister

    hornmeister Tired

    Someone was doing well. Only managed an A500 myself. Flight of Fantasy pack.
    http://www.bambi-amiga.co.uk/amigahistory/flightfantasy.html

    Worked in the school holidays to save up to buy a 14" sony trinitron TV so I could use the SCART connection and ditch the modulator.

    Dammit now I've got to go and find a copies of Rainbow Islands and Escape from the Plant of the Robot Monsters.
     
    SkylaRose likes this.
  31. SkylaRose

    SkylaRose Administrator Staff Member

    To be honest the difference between the systems is very small by today's margins. I did have an external disc drive so I could handle games with two discs though. Rainbow Islands kicked my ass as a kid, and still kicks my ass now as an adult. Never did past Robot Island without a cheat code, and even then getting the "secret islands" where you have to collect all the gems in the colours of the rainbow was very frustrating. Dracula boss of island three was a nightmare.

    One of the best paint programs was Deluxe Paint I think? I also loved the "insert disc" screen. and the fact to add cheats you had to code them yourself. "Pokes" they were called.
     

Share This Page