Uh oh!
There was an error while loading. Please reload this page.
Add meta doc summarizing dependencies - #217
Conversation
This doc explains the high-level purpose of the various dependencies and provides links to documentation for each.
Qard
commented
Oct 9, 2015
@nodejs/documentation @nodejs/website Can I get a LGTM, just for good measure? :) |
phillipj
commented
Oct 11, 2015
Should it be linked to from the docs section right away? |
fhemberger
commented
Oct 16, 2015
Now we have PRs for adding pages as docs, meta docs, guides, topics and knowledge base. This is confusing for the users (at least it is for me now). I think having less categories (and/or a clearer structure) would be a better approach. Otherwise LGTM. |
Qard
commented
Oct 16, 2015
The intent is for there to be separate sections for different types of docs: reference, guides, topics and meta (which is about developing node itself). This was what the Docs WG had decided on back at NodeConf. Do you feel differently? We're always open to feedback. 😺 |
fhemberger
commented
Oct 16, 2015
Sorry, didn't get the Docs WG memo. Is there a doc/issue on this topic you can point me to? It's hard to trace back decisions that were made at a conference. 😉 How is this related to the Knowledge Base discussed in #211? I know this is content originally coming from Nodejitsu, but as a new user coming to the website I would probably have a hard time to decide what the difference between "Knowledge Base", "Guides" and "Topics" is. |
Qard
commented
Oct 16, 2015
The original idea is mapped out in the trello board linked in nodejs/docs#1. |
Qard
commented
Oct 16, 2015
As for the Knowledge Base stuff, that hasn't really been discussed yet, but I agree that it overlaps a lot. I suspect the articles from it might get divided up into our topics and guides sections eventually. |
fhemberger
commented
Oct 16, 2015
@Qard Thanks for the link! |
fhemberger
commented
Oct 22, 2015
@Qard I'd like to merge this. Can someone please add a link to the website? @bnb offered to take care of this (#254 (comment)). |
bnb
commented
Oct 22, 2015
@fhemberger I'll do it. Just add the link in the other issue? |
Qard
commented
Oct 22, 2015
It should be fine to just merge this and leave linking to it to another PR. |
Add meta doc summarizing dependencies
Note: This is part of the migration of content files from https://github.com/nodejs/docs, see: nodejs/docs#44
This doc explains the high-level purpose of the various dependencies and provides links to documentation for each.