search

nodejs / next-10

Repository for discussion on strategic directions for next 10 years of Node.js
Other
477 stars 24 forks source link

Should we remove old draft docs? #236

Open wesleytodd opened 10 months ago

wesleytodd commented 10 months ago

https://github.com/nodejs/next-10/blob/main/VALUES_AND_PRIORITIZATION.md

As an example. I was referencing this in a thread but forgot it was outdated.

wesleytodd commented 10 months ago

Or at least maybe we sync them up?

GeoffreyBooth commented 10 months ago

I think it’s worth preserving the history somehow, if we can do so while avoiding people mistaking early drafts for the final versions. Maybe we can just use git for that? Like replace the contents of each file with just a single paragraph like:

The final version of this document is at [URL to final version]. You can see the history at [URL to git history of the current file].

Then it’ll be really obvious when you’re reviewing early drafts.

sheplu commented 10 months ago

It would made sense, especially to not have not synchronized