Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DOCS] Update docs #192

Merged
merged 5 commits into from
Mar 14, 2022
Merged

[DOCS] Update docs #192

merged 5 commits into from
Mar 14, 2022

Conversation

alexander-nitsche
Copy link
Contributor

@alexander-nitsche alexander-nitsche commented Mar 14, 2022

Hi Sybille,

i just came across your extension documentation while having a look at intercept. This PR is to align with similar documentations, that want to improve the guiding of the user. It provides him or her with all required information, especially with links to the next steps like installation and full documentation.

It further fixes some reST formattings and some configurations to increase contributions to the extension.

Greetings, Alex

Related: TYPO3-Documentation/T3DocTeam#182

- move status badges to top to align with similar extensions
- replace TYPO3 compatibility text with compatibility badges to shrink the vertical space
- use common title pattern "TYPO3 extension " to make the context of this application clear at first glance
- align abstract text with abstract text of Documentation/Index.rst
- link to other involved extensions of the TYPO3 universe
- add table with links in prominent place to guide reader to next steps (full documentation and installation)
- treat TER page as homepage of project instead of Packagist page as the former also links to Packagist
- remove deprecated t3author and description properties
- include footer links to the TER page for installation and contact
  to conveniently guide the reader to all aspects of the extension
- remove unused and update used intersphinx mappings
- rename Includes.txt to Includes.rst.txt to support
  reST syntax highlighting in the IDE
- use absolute path of Includes.rst.txt to harmonize inclusion
  in all reST files
- fix reST syntax of "linkCheckingOnTheFly" label
- cross-reference "columns-input-properties-softref" label
  in foreign TCA manual
- replace unknown code-block language "tsconfig" adequately
- header underlinings must have at least the same length as
  the header text
- fix duplicate "tsconfigMailLanguage" label adequately
- use proper commenting in Sitemap.rst
- align abstract text with abstract text of README.md
- use HTTPS in TYPO3 URL
@sypets
Copy link
Owner

sypets commented Mar 14, 2022

Hi @alexander-nitsche thank you so much for your work! I already noticed you streamlined and improved some standards and conventions but I must admit I am not aware of all the latest and greatest. I will have a look ... (may take a bit but will try to find time today).

@sypets sypets merged commit a3cf4ec into sypets:main Mar 14, 2022
@alexander-nitsche alexander-nitsche deleted the task-update-docs branch March 15, 2022 07:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants