Remove select-get from Language Reference Docs #1747
Conversation
tbrinkman3
changed the title
|
I don't think it's a good idea to remove sections from the language guide because they're documented in the book. The language guide performs a slightly different task than the book and things like this should be minimally documented in the guide. |
|
@fdncred To be fair, I added that page and TODO in the Language Guide a while back, then added the |
|
I think the language guide should have every language related item in it. Even if it's just a high-level blurb that points to more in-depth documentation. |
|
@fdncred (Delayed response) That's fair, but considering this is only a page with a "TODO" on it, I think we should remove it for now and add something in when we have real text, right? There are literally hundreds of potential TODO pages still to be written in the Language Guide. :-) |
|
@NotTheDr01ds I'm up for whatever, but imo, i'd rather see TODOs because it shows potential contributors what's missing and specifically where they could jump in and help. If there are no TODOs, one would think that it's complete, which it is far from. Or even some other blurb that conveys that same intent, "Please help by documenting this section". |
|
No worries - I don't have strong feelings on it either; it's just that we don't have many other TODOs today. Perhaps the Language Guide should be an exception there, since it still needs a lot of content. |
|
I guess the question is - Should we land some version of #1744 then? Or what would you see as the "Language Guide" version of this section? |
|
Ya, I'd just have a small-ish blurb like that PR for get/set. |
Already documented in the Book. Removing duplicate location. See: #1744