Update Website & Documentation

[PhrozenByte]

@PhrozenByte commented on 6 Feb 2016

This is a long-live issue to track and discuss wished updates of our website resp. documentation.

Please refer to picocms/Pico#323 for previous discussions.

Website

• Add GitHub, Twitter and IRC icon to website
• Add current version number to Download page
• Overhaul and extend _development/ collection resp. development.md
• Improve _cookbook/ collection resp. cookbook.html
  • Decide where to put links to it (inline user docs? website user docs? website dev docs?) and actually create the links
• Customization Redesign & Portfolio Pico#358: Use Webpaint portfolio ("Showcase") to re-implement customization.md with extended information about and screenshots of all plugins and themes
  • Use distinct data files (_data/plugins.md and _data/themes.md) to make adding plugins/themes much easier
  • See phpDoc.html and _data/phpDoc.md as a reference
• Look through the wiki to include more plugins and themes on Pico's website
• Decide where to put large source files, see Customization Redesign & Portfolio Pico#358 (comment) and following
• Add a sane way to add "Read more..." pages (e.g. upgrade.md or nginx.md (Improve Nginx Documentation Pico#343))
• Add a phpDoc overview page Pico#309: Add a phpDoc overview page
• Nginx Documentation Pico#345: Add extended nginx documentation
• About Page Pico#349 + About Page & Fancybox / Portfolio Template Pico#352: Add "About Us" page
• Add support for serving static files from content folder Pico#368: Create a "advanced asset handling" howto (allow access to certain files (matched by MIME type) in the content/ folder)
• create docker-compose.yaml Pico#387: Create Docker tutorial

Decisions to make

• Replace <h2> headers with a floating box in the TOC-reserved space on the left, see About Page Pico#349 (comment) for an example

Documentation

• Add IRC to the "Getting Help" section
• Add the "What information do we need" paragraph of the Issues section of our CONTRIBUTING.md to the "Getting Help" section
• Explain how to use Pico with composer require picocms/Pico and provide a appropriate index.php
  • Maybe create a distinct pico-composer project instead? See Pico 4.0 and beyond Pico#317
• Pico 2.0: Update nginx rewrite rules in user docs/nginx details page
• Add a basic YAML tutorial/guide/howto
• Add a basic Markdown tutorial/guide/howto

[PhrozenByte]

New:

• Add a basic YAML tutorial/guide/howto
• Add a basic Markdown tutorial/guide/howto

[stefanocpp]

Hello! About improving cookbooks, I have a proposal about feed generation.
The code there puts everything up in the feed, while you might just want to push out new stories or articles.
I tried and used some code @PhrozenByte suggested some time ago to rule-out pages without a date or a meta.unlisted.

The idea is to replace
{% for page in pages if page.id not in ['index','feed'] and not end %}
with
{% for page in pages if page.time and not page.meta.unlisted %}