You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Subitle: Make TYPO3 docs landing pages look less like Work in Progress
This manual and especially the pages "Guides and Tutorials" and "References" are very prominent and important. They might be the first place someone looks who is new to TYPO3. For TYPO3 marketing purposes and in the intention of providing the best guidance, especially for new users, I think it is very important to clean up this page and make it look less like work-in-progress. I realize, there is still a lot of work to do, not every manual is in a final state and there are far less people working on things than are needed, but this page does not necessarily have to reflect that.
I think we should try to come up with pragmatic solutions for fixing this asap.
Proposal
Remove outdated manuals and WIP manuals (or better remove WIP tag if no longer applicable) from this list. If the WIP manual is the only thing we have, so be it. Strip it down to the basics and do the WIP work in a different place.
remove comment "The Extbase book" because it is redundant
remove or replace comment "Very unsufficient, but better than nothing." because it looks bad and is not helpful
If manuals are really hopelessly outdated and considered harmful, remove them entirely from this list. Maybe even remove them entirely
Possilby create another lists for old, deprecated and wip manuals.
Example:
For example, currently we have:
People wanting to learn will be confused, ok there are 2 manuals. Why? One is "better than nothing", where should I start? And get a bad first impression of TYPO3 docs. What??? Why don't they maintain their documentation?
This could look like this:
change "Very unsufficient, but better than nothing." to a more descriptive phrase, e.g. "outdated", remove the book entirely from this list (if it is really so outdated) and move it to the old / deprecated / wip list
remove comment "The extbase book", because the title already says it all
The text was updated successfully, but these errors were encountered:
Subitle: Make TYPO3 docs landing pages look less like Work in Progress
This manual and especially the pages "Guides and Tutorials" and "References" are very prominent and important. They might be the first place someone looks who is new to TYPO3. For TYPO3 marketing purposes and in the intention of providing the best guidance, especially for new users, I think it is very important to clean up this page and make it look less like work-in-progress. I realize, there is still a lot of work to do, not every manual is in a final state and there are far less people working on things than are needed, but this page does not necessarily have to reflect that.
I think we should try to come up with pragmatic solutions for fixing this asap.
Proposal
Example:
For example, currently we have:
People wanting to learn will be confused, ok there are 2 manuals. Why? One is "better than nothing", where should I start? And get a bad first impression of TYPO3 docs. What??? Why don't they maintain their documentation?
This could look like this:
The text was updated successfully, but these errors were encountered: