search

freeCodeCamp / wiki

freeCodeCamp's deprecated wiki articles
http://www.freecodecamp.com/wiki
281 stars 308 forks source link

Wiki migration over to the forum #1211

Closed Rafase282 closed 8 years ago

Rafase282 commented 8 years ago

Objective:

We need to migrate our current wiki to the forum and try to do it right the first time.

Important Notes:

We are using the forum branch for this chances, do not use master. Always make sure to make the PR against this branch, and to sync the branch before you make new changes. If you need help figuring out where to put the article or if you feel a category is needed then let me know and I'll create it for you.

To make collaboration easier, before you start, it would be good to select a number of articles that you want to work on and let us know here beforehand to avoid issues.

I recommend to focus on the articles with no internal links or/and little to not backlinks. I define backlinks as links from other articles that point to the article in question, for those, the links would need to be updated as well.

For articles that have been updated as in PR against them accepted, then let me know so I can update them, I normally keep an eye for these anyways.

Steps on Moving the Articles:

  1. Select the right section and subcategory for the article.
  2. Copy and paste the article with the same name as the heading in the article, if some alterations are needed, feel free to, so it reads more fluid, there is a limit of 15 characters for the title so those with shorter name will require a new title.
  3. Save the post, then make it a wiki and if you can, make it use staff color, if no is fine.
  4. Change ownership to me, at this point I can add the staff color if needed.
  5. Copy the full url of the new wiki article and replace it on the articles that referenced the old article. This can be done with a search and replace on the whole project. I use atom for it. Feel free to use whatever tool you have available.
  6. Once you are done adding articles, then save then commit the changes on the branch and follow the steps on the PR above.

    Tracking the changes via pull requests:

  7. Assign all wiki mods, this is mostly to let them know the status, I also assign @QuincyLarson for that reason too.
  8. The PR would remove the articles that have been added to the forum and no longer need changes.
ghost commented 8 years ago

I am taking on all CSS and Java prefix articles :+1:

Rafase282 commented 8 years ago

@atjonathan unless you will do them all in one sit,I would prefer that you take on a group that you can finish before you have to do anything else. So for example you can do all the CSS, and once you finish then take on the Java ones if no one is working on those.

ortonomy commented 8 years ago

Curious - why are you moving the wiki to the forum? Surely a forum is a forum? It will be awkward to read wiki articles on a forum.

alayek commented 8 years ago

@geligelu one of the main reasons was that our Wiki was not getting enough traffic as compared to our main site, forum, chat rooms etc.

We work rigorously on the Wiki, and we would like to see some traffic.

Another reason was that people needed to learn Git and GitHub to be able to contribute to our Wiki. This was prohibiting our campers from contributing their knowledge to our Wiki. Forum based Wiki gives you a simple way of history management.

ortonomy commented 8 years ago

@alayek - very reasonable rationale, agreed. One thing I would add: I didn't know the wiki contained hints and solutions to the algorithms until I poked around in it, half way through the front-end course. Might also be a communication thing - at the start with all the orientation in addition to 'search, read, ask' add (that includes our wiki). Small, but might would direct people to wiki instead of goole first...

alayek commented 8 years ago

@geligelu touche!

IsaacAbrahamson commented 8 years ago

Do you have to be staff to help, or can anyone copy-paste the wiki pages to the forums and commit?

Rafase282 commented 8 years ago

The pages were already moved.

On Mon, Jul 25, 2016, 1:03 PM Isaac Abrahamson notifications@github.com wrote:

Do you have to be staff to help, or can anyone copy-paste the wiki pages to the forums and commit?

— You are receiving this because you were assigned. Reply to this email directly, view it on GitHub https://github.com/FreeCodeCamp/wiki/issues/1211#issuecomment-235015845, or mute the thread https://github.com/notifications/unsubscribe-auth/AARZ0sIFr0wwRov4GnVQzKnSde1OjvVpks5qZOxjgaJpZM4JDvYJ .

Kind Regards,

Rafael Rodríguez Junior Web Developer https://rafase282.github.io/

carlosvigil commented 8 years ago

I see the pages were moved, will this wiki and issue be updated relaying that information?

Rafase282 commented 8 years ago

All the pages have been moved and mentioned before. This means for those wanting to contribute to the wiki, you will have to edit or create articles on the forum. When creating them, make sure to mark them as wiki articles.