Checklist

A Checklist For All Trainings

Repository Structure For the /

• A main conf.py (for training.plone.org)
• Main test directory
• Main build (make) file (for build and deploy all)
• Main index
• Main /about with good content and info about all trainer
• Main glossary

Repository Structure Per Training Directory

Each training lives in its own directory and should be able to build by its own.

• A conf.py, configured per training
• A index.rst
• A glossary with 'special words' for this certain training ¹
• A unified about directory/chapter with explanations and links to other trainings/main training site

Tests

This tests will be run against the repository via CI.

However if you start writing it would be helpful and faster to include these already in your local writing flow.

• Spell-check
• Word consistency (like GitHub, JavaScript)
• No 'So' at the beginning of sentences
• One sentence per line
• Line limit more or less 130 characters
• Documents not longer than 1000 lines
• Link-check
• Catch insensitive, inconsiderate writing (http://alexjs.com/)
• (Certain) weasel words (https://github.com/btford/write-good)

Bonus Tests

• Check for Unexpanded Acronym

Deployment

• Build and deploy every training 'standalone'
• Build and deploy all in one

Notes

1 Example: In the deployment training we have AWS (Amazon Web Services) as 'special'. ↩