GeezerVison is showing github.com — Delete the FAQ · Issue #27 · python/devguide
DescriptionIt's not necessary as it was written for a time where we used version control systems that aren't as widely used or documented at git. All references should also be removed. Activitywillingc commented on Aug 14, 2016 A suggested workplan to address this issue:
- Verify that any useful content (esp. section 29.1 Communications) is found elsewhere in the devguide. If not, migrate that content to an appropriate devguide section.
- 29.1 Communication
- 29.2 Version control
- 29.3 SSH
- 29.4 General
- Remove all FAQ content and references to the FAQ.
brettcannon commented on Aug 15, 2016 I don't think we should document version control stuff outside of our workflow as there's enough content on git online, so I say just drop that section. The same I think goes for SSH. Reacted by Carol Willing and Kushal Das Mariatta commented on Dec 9, 2016 Is the FAQ ready to be removed? I can prepare a PR 😃 brettcannon commented on Dec 9, 2016 Someone should go through the FAQ to see if there's any relevant info in there that isn't either easily/better found elsewhere online or that is replicated in the proper place somewhere else in the devguide. So I don't know if it's ready yet until that's occurred. willingc commented on Dec 9, 2016 @Mariatta If you have time to go through the FAQ, that would be awesome. Thanks! brettcannon commented on Dec 10, 2016 Yes, if that wasn't clear, it's open to anyone to try and tackle. 😄 (long list of todos today that I'm trying to rush through) Reacted by Carol Willing and Mariatta willingc commented on Jan 4, 2017 ezio-melotti commented on Feb 23, 2017 A bit late to the party, but just yesterday I was looking for faq.rst and then accidentally came across this issue.
I think removing it was a bad idea, and just by reading the diff I got answers to a few questions I had that are currently not covered in the devguide.
I also disagree with the rationale:
It's not necessary as it was written for a time where we used version control systems that aren't as widely used or documented at git.
Even though I was familiar with HG (I wrote several of those FAQs myself), I often went back to them to look up the exact list of commands I needed to solve a particular problem. While it's true that the same answers can be found online, there are several possible workflows and variations that need to be adapted to our workflow and repo structure. The commands in the FAQ were easy to find and copy/paste. brettcannon commented on Feb 24, 2017 I think the general feeling has been that instead of a FAQ we should have a doc(s) that cover scenarios and include the appropriate instructions. So that would mean if you were looking for something and it wasn't in the relevant doc that covered that scenario then that doc needs an update instead of a random entry in an FAQ. Reacted by Mariatta and Carol Willing ezio-melotti commented on Mar 2, 2017 This works for me as long as the commands are documented and easy to find. You could argue that each scenario answer a specific question though :)
MetadataMetadataDevelopmentNo branches or pull requestsIssue actions
|