Git Product home page Git Product logo

csharpplayersguideearlyaccess's Introduction

C# Player's Guide - Early Access

A place to track issues with The C# Player's Guide for patches and future editions.

csharpplayersguideearlyaccess's People

Contributors

rbwhitaker avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

csharpplayersguideearlyaccess's Issues

Update map to reflect Part 1 revision pass

After some significant revising in Part 1, the map at the start of the book is no longer accurate. It needs to be updated.

  • Remove "More Math"
  • Rename cities to match new level names.

Page 63 - "The compiler an often infer what types are in used..."

Two errors in this one sentence. Should be "The compiler can often infer what types are in use..." but I wonder if it couldn't also be made clearer a different way. Maybe "The compiler can often infer the type of a variable from how it is used. Listing var as a variable's type tells the compiler to use the inferred type, instead of writing it out yourself. (But the variable still has a specific type.)"

Doublecheck all XP

I've had two reports of XP being wrong, when comparing the chart at the beginning of the book against what the book actually says. I need to systematically go through them all and make sure they are right, and consider if making references to the numbers is worth the overhead to be able to know that XP will either be right or broken links.

// Pixar's 'Up'

This is a comment in the early part of the book before learning about comments. I don't think it adds any real value, and should be removed.

Test Issue

This is a test of the emergency issue system. in the event of an actual issue life would of collapsed in on itself and time would end. thank you.

Provide solutions for Level 24 challenges

Eventually, I need to create and post solutions to all challenges in the book. I have not been doing that as Early Access progresses, but the challenges in Level 24 are substantial enough that they deserve the solutions now rather than later.

The scope of this story is to create solutions for each of the nine challenges contained in Level 24 (The Catacombs of the Class) and put them on GitHub. A ZIP file of that repository will be placed in the artifacts for the EA3 download. The solutions do not need to be on the website yet.

  • The Point
  • The Color
  • The Card
  • The Locked Door
  • The Password Validator
  • Rock-Paper-Scissors (Design)
  • 15-Puzzle (Design)
  • Hangman (Design)
  • Tic-Tac-Toe (Full game)

Page 57 - "how much actual space in memory we must reserve for the memory location, among other important benefits"

"By knowing a variable's type, we know how much actual space in memory we must reserve for the memory location, among other important benefits."

For starters, this should be:

"...how much actual space in memory we must reserve for the variable, among other important benefits."

But it could also maybe be shortened to "By knowing a variable's type, we know how many bytes in memory to reserve for the variable. Knowing a variable's type is also key in getting the compiler to make sure we are using our variables correctly."

The "among other important benefits" is not a very helpful phrase. If I don't elaborate on what those benefits are, then I should just delete the phrase.

Page 32 - first sentence is confusing

"Modern day programming is complex and challenging, but a programmer does not have to go it alone."

The "go it alone" phrasing was reported as being confusing/wrong. I'll look into seeing if there's a way to phrase this differently.

Page 43 - "You think you can manage that."

This one is grammatically correct, but not as clear as I had hoped. Figure out a different way to phrase it, or consider just removing the sentence. I'm not sure it adds much to the challenge.

Write Advanced Null Reference Types article

The book is going to leave out some details about configuring nullability checking and leave that to an article on the book's website. This story requires writing and posting that article so that it is available when the Null References level is published.

Defense of Consolas XP

The table at the start of the book uses 150XP, but the book itself uses 200. 200 is the right number, and the table at the start needs to be updated.

Make single page map

For digital downloads, I want a single page map in addition to the two-page map at the start of the book. For a digital download, it is okay for this map to be larger than a sheet of paper.

Determine ISBN

This needs to happen sooner or later, but there was a request to do it sooner rather than later for school bookstores.

This won't get the book available for purchase any time sooner, but may make the stores feel like things are ready to go for when that time arrives.

Page numbers in the introduction are wrong.

The introduction currently uses Arabic numerals (0-9), even though it is currently considered front matter. That means there are two pages labeled Page 22 in the book, which is bad.

There are two potential solutions:

  1. The Intro was originally supposed to use Roman numerals instead. Make this work like it used to.
  2. Make the Intro and possibly the Acknowledgements use Arabic numerals, but start page numbering over when that starts and do not reset it afterwards.

Page 58 - "Remember that names are meant for humans to use, not the computer"

"Remember that names are meant for humans to use, not the computer. So pick names that help human programmers make sense of what is going on, not things that you think will make life easier for the computer."

This was reported as being unclear, and I agree. A suggestion was made to make it "Remember that variable names..." and I think that's a good suggestion. The second part was also reported as being unclear. Perhaps the following is clearer?

"Remember that variable names are meant for humans to use, not the computer. Pick names that help human programmers understand what it is for."

Page 12, "was" should be "has"

"Of the IDEs we discuss in this level, this is the most feature rich and capable, though it was one important drawback:..."

Should be:

"Of the IDEs we discuss in this level, this is the most feature rich and capable, though it has one important drawback:..."

Page 63 - "These are the foundation but are only the beginning"

This was reported as incorrect (should be "foundations" not "foundation") though I think it could be okay. But that bullet point isn't all that great in the first place. Perhaps something more like, "These types are the building blocks of a much larger type system."

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.