mcruzWMF added a comment.
In T219806#5252874 <https://phabricator.wikimedia.org/T219806#5252874>, @SandraF_WMF wrote: > Thanks for your feedback, María! Hang and I are checking in later today to go through feedback in person. Please note that I am the one who created the workflow graphic <https://commons.wikimedia.org/wiki/File:Data_and_Media_Partnerships_Workflow_v2.svg> last year - that image is not Hang's work! That said, guidelines on how to create and improve such graphics in the future are very welcome. Yes, I figured it was your creation, Sandra =) > > > 1. Thoughts on next steps > > While writing first bits of (dispersed) documentation, for instance in the This Month in GLAM newsletter (example <https://outreach.wikimedia.org/wiki/GLAM/Newsletter/April_2019/Contents/Structured_Data_on_Wikimedia_Commons_report>), I have discovered that, in addition to the designs you created up till now, we may need template-based solutions and procedures for the following: > 1. Menus for, and navigation inside, longer pieces of documentation > > I think a lot of the documentation will consist of multiple steps, or will in general benefit from being cut into smaller chunks. Some readers will want to skip some of these steps because they are not relevant to their use case or they already know how to do that specific thing. So I think it may be good to have > 2. A system/template to create a 'menu' (similar to the tab system used by many WikiProjects on Wikidata, for instance - example <https://www.wikidata.org/wiki/Wikidata:WikiProject_Built_heritage>) > 3. A system/template for pagination (when documentation has e.g. dozens of consecutive subpages) > 4. A system/template for skipping to a previous/next bit of documentation We have some really good navigation templates that we developed for the Wikimedia Resource Center. Consider reviewing: - Template:Portal navigation <https://meta.wikimedia.org/wiki/Template:Portal_navigation> - Template:Stackable card <https://meta.wikimedia.org/wiki/Template:Stackable_card> before developing anything new. These templates work really well on mobile, are versatile and you can add your own formatting, too! If you'd like to improve them in any way, that is also welcome. The module to edit the template is here <https://meta.wikimedia.org/wiki/Module:Portal_navigation>. > > > 1. Integration of screenshots, gifs, explanatory videos > > The documentation will likely include many screenshots and short explanation videos. Perhaps also animated gifs - I welcome your opinion on experiments like this one <https://outreach.wikimedia.org/wiki/File:Adding_multilingual_captions_to_a_file_on_Wikimedia_Commons_-_animated.gif> (you can also see it in use in this story in This Month in GLAM newsletter <https://outreach.wikimedia.org/wiki/GLAM/Newsletter/May_2019/Contents/Structured_Data_on_Wikimedia_Commons_report>). It would be nice to have guidelines and/or templates to integrate these into documentation as elegantly as possible. I can imagine they can be put in the callout boxes you've already designed, but maybe they can benefit from their own place/design (bordered? width? alignment?). This ^^ we don't currently have, and it would be good to develop resources for this need. I think @hdothiduc was doing a good job in this area with the callout boxes. > Curious what you think, and if these additional design frameworks would fit into your upcoming planning. TASK DETAIL https://phabricator.wikimedia.org/T219806 EMAIL PREFERENCES https://phabricator.wikimedia.org/settings/panel/emailpreferences/ To: hdothiduc, mcruzWMF Cc: mcruzWMF, hdothiduc, Quiddity, SandraF_WMF, darthmon_wmde, Nandana, JKSTNK, Lahi, PDrouin-WMF, Gq86, E1presidente, Ramsey-WMF, Cparle, Anooprao, GoranSMilovanovic, QZanden, Tramullas, Acer, LawExplorer, Salgo60, Silverfish, _jensen, rosalieper, Susannaanas, Jane023, Wikidata-bugs, Base, matthiasmullie, aude, Ricordisamoa, Wesalius, Lydia_Pintscher, Fabrice_Florin, Raymond, Steinsplitter, Mbch331, Qgil
_______________________________________________ Wikidata-bugs mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/wikidata-bugs
