Decommission wikidot site

[obfuscurity]

We need to kill http://graphite.wikidot.com/ with 🔥, sooner rather than later. Unfortunately there are some content gaps in the RTD site (0.9.x, 0.9.12, etc) documentation site that need to be addressed before we can safely decommission the former. Please detail any below that you can find and I'll make sure to crosslink accordingly.

[obfuscurity]

The "Initial Configuration" section has no content.

http://graphite.readthedocs.org/en/0.9.12/install.html#initial-configuration

[obfuscurity]

/cc @graphite-project/committers

[esc]

+:100:

[esc]

Get rid of the old site, it is just confusing for our users.

[obfuscurity]

@esc I totally agree but we need to identify and fill those content gaps first.

[brutasse]

Pages that don't really have an equivalent in the current docs/ layout:

• http://graphite.wikidot.com/faq
• http://graphite.wikidot.com/installation -- there's no real summary page like this one
• http://graphite.wikidot.com/getting-your-data-into-graphite -- some useful prose for newcommers
• http://graphite.wikidot.com/quickstart-guide -- we should not advertise run-graphite-devel-server but there's also some useful information
• http://graphite.wikidot.com/cli-reference and http://graphite.wikidot.com/cli-tutorial
• http://graphite.wikidot.com/high-level-diagram -- not sure what Pyped is
• http://graphite.wikidot.com/whisper -- some parts are maybe a bit out of date
• http://graphite.wikidot.com/carbon -- also a bit of outdated information here
• http://graphite.wikidot.com/roadmap -- not sure client-side rendering is being worked on, at least not in graphite-web itself :)
• http://graphite.wikidot.com/federated-storage

[obfuscurity]

@brutasse My thoughts on your list...

• http://graphite.wikidot.com/faq
  • should be a page on the new site
• http://graphite.wikidot.com/installation
  • the quickstart thing mentioned here
• http://graphite.wikidot.com/getting-your-data-into-graphite
  • should be merged into feeding-carbon.html
• http://graphite.wikidot.com/quickstart-guide
  • either overlaps with the aforementioned quickstart guide, or another quickstart (on the new site) in its own right
• http://graphite.wikidot.com/cli-reference and http://graphite.wikidot.com/cli-tutorial
  • @brutasse ripped out the cli, yay
• http://graphite.wikidot.com/high-level-diagram
  • a diagram should exist somewhere, not sure where yet
• http://graphite.wikidot.com/whisper
  • any relevant bits should be merged into the FAQ
• http://graphite.wikidot.com/carbon
  • any relevant bits should be merged into the FAQ
• http://graphite.wikidot.com/roadmap
  • this can be removed imho
• http://graphite.wikidot.com/federated-storage
  • something resembling @bitprophet's federation doc should exist in the RTD

Good list. If we come to some consensus I'll begin adding issues to knock this stuff out. No need to rush to destroy wikidot until these items have been addressed and the new site is live.

P.S. I suspect PypeD was a StatsD-like aggregator used in Orbitz.

[esc]

You may want to delete/redo the http://graphite.wikidot.com/high-level-diagram

Other than that I am in favour of the aggregations you suggested.

[obfuscurity]

Yeah, the diagram definitely will be replaced by something.

[gwaldo]

How have y'all been reviewing the rst files? I've done a little work on the install/configure section, and want to validate.

[gwaldo]

Made a dent on the Install / configure sections. Nothing pretty (and not yet validated), but attempted to sanely capture what was missing from wikidot into the current docs. PR coming as soon as I review/test.

[obfuscurity]

Oh, and just so we're clear, it's very important that as much of this work as possible is backported to 0.9.x. Otherwise we won't be able to decommission wikidot since the vast majority of our users will be on 0.9.13 and looking at those sad, broken docs.

🍺, 🍰 and 🍦 for all of our docs helpers and maintainers!

[gwaldo]

regarding "The "Initial Configuration" section has no content. http://graphite.readthedocs.org/en/0.9.12/install.html#initial-configuration", I copied in the files within docs/ that had been modified in the past week or so (since I'd started contributing) into the 0.9.x branch. While the latest and 0.9.x versions of the RTD site have updated, the 0.9.12 (and older) versions have not been updated.

Is this expected behavior? Can anyone explain to me how the RTD mechanism works?

[obfuscurity]

That sounds correct. Older versions are built from the project tags. Since we haven't merged any of the fixes in master or 0.9.x into the respective tagged releases, we shouldn't expect to see those fixes in 0.9.12 or older. But they should appear in 0.9.13 once that's tagged and released.

This is as I understand RTD to work. Someone else please correct me if I'm mistaken.

[obfuscurity]

I've enabled a redirect module for the wikidot site in #5. I don't think we need to formally decommission the old wikidot site as long as this 301 redirect is in place. Closing.