Inventory all the existing content on docs.lfe.io

[oubiwann]

Once we have this list of everything on docs.lfe.io, we can group it along the best possible lines (allowing content to appear in more than one section when it makes sense).

Once the content is grouped, we can prioritise: which things should get highlighted? Which content should users be guided towards?

For the new docs2 site, we need to keep in mind simplicity: high light the top three things (for example) in each section, and then provide more full details after that. We need to keep in mind the pain of the current docs site:

• key information is not highlighted
• information is cluttered
• information is not well organized
• too many hidden jewels that no one finds
• unclear versioning of content with LFE releases

Part of the Planning Epic.

[oubiwann]

docs.lfe.io resources identified (so far):

• http://docs.lfe.io/tutorials/processes/1.html
• http://docs.lfe.io/tutorials/mnesia/1.html
• http://docs.lfe.io/tutorials/counter-app/1.html
• http://docs.lfe.io/presentations.html
• http://docs.lfe.io/prog-rules/1.html
• http://docs.lfe.io/style-guide/1.html
• http://docs.lfe.io/user-guide/intro/1.html
• http://docs.lfe.io/history.html
• http://docs.lfe.io/examples.html

Update:

I removed all the non-docs.lfe.io links. Those belong in ticket #63. I've also added more docs.lfe.io-only links.

[rvirding]

So the problem is not the lack of documentation, it is putting them all together in a decent way. :-)

[oubiwann]

Indeed! And the docs above aren't even the complete list! (I'll be adding more/up[dating that comment as I have time to do more digging).

I've been making steady progress on a solution, though. It's starting to turn into a fun problem and one that will be not painful to maintain over time.

[oubiwann]

Calling this one done.