== Start We are thinking about a slightly new way of creating PlantUML documentation. This is an attempt to replace the existing http://wiki.plantuml.net/site/index[Dokuwiki site]. Right now, this website is still under test. At some point, the existing wiki will be imported here. We have decided to support several syntaxes of wikis. Right now you can use: * link::syntax-dokuwiki[Dokuwiki syntax] * link::syntax-markdown[Markdown syntax] * link::syntax-asciidoc[Asciidoc syntax] And you can link::poll-about-wiki-syntax[Vote for your syntax!] Each user can really use whatever he prefers: the wiki convert user's contributions on the fly. == Your Help Needed! It's really easy for people to contribute doc additions and fixes using their favorite syntax. Most of the important Wanted Features (__initially discussed at the https://github.com/plantuml/plantuml/issues/67[plantuml Documentation project]__) are now implemented, and the PlantUML team will be adding more. So now it's time for the community to step up and to help documenting this wonderful program better! Here is how you can help: * Document your favorite features * Go through the list of https://github.com/plantuml/plantuml/issues/261[Undocumented plantuml features] or on **this wiki**, with list for follow link::undocumented[Undocumented PlantUML features in order to document] and work out some of them. It's a categorized list of 100-200 tasks that need your help * Post questions, issues and finding in the https://forum.plantuml.net/[forum] == Recommendation and Best practice * Avoid to put style on title (no raw, italic or bold...) == Wanted Features * Fully anonymous access: you won't have to create an account to __edit__ contents [[#98FB98#DONE]] * Advanced SPAM protection: we use branches when people edit content, so spam contributions will not have to be cancelled, they will just be never merged and we won't even have to delete them. [[#98FB98#DONE]] * Automatic page creation: just go to http://alphadoc.plantuml.com/doc/en/any-page-you-want[http://alphadoc.plantuml.com/doc/en/any-page-you-want] [[#98FB98#DONE]] * Possibility that each contributor uses its favorite wiki syntax. [[#98FB98#DONE]]: asciidoc, dokuwiki, markdown * Duplication of plantuml code [[#98FB98#DONE]]: shows as source and as diagram * Automatic generation of PlantUML diagrams [[#98FB98#DONE]]: see next section * Possibility to create named user/login for serious contributors [[#FFD700#TODO]] * PDF generation through LaTeX [[#FFD700#TODO]] * Automatic consistence between translated versions [[#FFD700#TODO]] * Automatic synchronization with some GitHub repository [[#FFD700#TODO]] * Automatic TOC/site map on the alphadoc site [[#FFD700#TODO]] * Automatic TOC/site map on the final site (not only on this alphadoc site) [[#FFD700#TODO]] * Sync to/from web site [[#FFD700#TODO]] * Link checking [[#FFD700#TODO]] https://github.com/plantuml/plantuml/issues/361[#361] * Ability to Update title/desc\* [[#FFD700#TODO]] (currently gives exception https://github.com/plantuml/plantuml/issues/363[#363]) * Use named anchors (perhaps even automatically anchor

,

,

, ... tag) so you can have stable `+#+` links within the documentation and linking from the outside [[#FFD700#TODO]] ** For now you can use the https://chrome.google.com/webstore/detail/display-anchors/poahndpaaanbpbeafbkploiobpiiieko[Display #Anchors chrome plugin] and hand-craft links eg like "alphadoc http://alphadoc.plantuml.com/doc/markdown/en/sprite#hdvb3xdf1doekdtyqgs2[sprite#stdlib] and http://alphadoc.plantuml.com/doc/markdown/en/sprite#jq1w8ezst4vzkdtyqu8b[sprite#listing-sprites]" but it's difficult, and those machine-generated anchors aren't guaranteed to be stable == Demo diagrams You can use a new special tag `++` for diagrams. ---- @startuml ... @enduml ---- The result is that the PlantUML source is shown, followed by the diagram: @startuml User -> Wiki : document, document, document... @enduml