Hello! We’ve been developing the plans for this TYPO3 guidebook, and now we’re inviting the TYPO3 community to give feedback on the book outline.
Inviting feedback from the community
Since our last post, I’ve returned to Germany to conduct more in-person interviews and attended TYPO3 Camp Mitteldeutschland in Dresden. Thank you very much to everyone who attended the barcamp session where I presented the project with TYPO3 Association President Olivier Dobberkau. It was incredibly helpful to have that discussion and feedback. We’re continuing to work directly with the community to gather insights and subject matter expertise to build consensus regarding book content.
At this stage, we’ve developed an outline and would like to validate it by getting direct feedback from community members.
A quick look at the book
Before we look at the outline, let’s have a look at how the book works. There are two main parts, an “Overview” with four chapters and a set of modular, hands-on “Guides.”
Part 1: The Overview is composed of four chapters designed to give a variety of readers enough information to understand how to work within TYPO3 as a CMS and as an ecosystem. We cover the capabilities, limitations, and requirements for successful TYPO3 projects as well as assorted user personas, software differentiators, and the supporting open source community.
Part 2: The Guides are a set of self-contained tutorials. Each starts with a use case and learning objective so it’s clear what you’ll be able to do when you complete the activity in each guide. These guides highlight what TYPO3 is really useful for, and contain clear step-by-step tutorials, diagrams, and where to find further information. We aren’t replacing anything in the existing documentation, but rather highlighting key procedures, best practices, and guiding you through solving your own challenges.
Onwards to the outline:
Review the outline - your feedback is welcome!
Thanks very much for reading along here and mulling over this project with us! We’ve captured the top level topics in this table of contents format. If you’d like more detail, please leave a comment or contact us with your questions and we can explain. We’d like you to review the outline and let us know:
- Do you feel there are any key topics missing?
- Is there something that is not needed in this guidebook?
- Is there something else you’d change, move, or clarify?
- Table of Contents
- Book outline
- [Intro message]
- What to expect when reading this book
- Who is this book for?
- Who wrote this book
- We’d love to hear from you
- Part 1 - How TYPO3 Works Overview
- Outline of overview section
- TYPO3 Showroom
- What you can build with TYPO3
- Unique TYPO3 features you’ll love
- Case studies
- Why TYPO3’s flexibility makes it easier to scope projects and plan
- Designing and planning with TYPO3
- TYPO3 is design and display-led
- Typical approaches to wireframing / site architecture
- Page tree and menu system
- TYPO3’s atomic components v other CMSs
- Visual design / Theming
- Building and Extending TYPO3
- TYPO3 layers
- Fluid templating
- Follow a request in TYPO3
- TER - TYPO3 Extension repository
- Building TYPO3 skills and resources
- Service ecosystem- aka where to get more help
- Launch and Maintaining TYPO3
- Content management and workflows
- TYPO3’s release cycle
- System requirements
- Multisite management
- Multilingual management
- Update process
- Maintenance tasks
- Service ecosystem
- Part 2 - Hands-on Guides [Potential guides, final TBD]
- Introduction to TYPO3 Guides
- List of TYPO3 Guides
- Choosing a preconfigured distribution or starting from scratch
- Guide to creating your first TYPO3 site (local setup w ddev!)
- Creating your first extension
- Choosing extensions (good for all audiences)
- Where to start customizing- tie-in points
- Planning, building, and using page components
- Content management
- Building an integration
- Guide to multi-site management
- Guide to multilingual websites
- Guide to integrating with Angular
- Guide to updating TYPO3
- TCA documentation, what to configure
- Graceful Error Handling - i.e. what to do with these errors?
- Where is the config for x?
- Permissions- creating restricted areas of your site
How to give feedback
Handy comments form is below! We'll add a contact form shortly as well. EDIT: please do leave a comment, we're troubleshooting an error with mail transport.
If you sign up to the newsletter, we’ll send you updates as we go.
Thank you again for stopping by, we really appreciate your time and thoughts.