Assorted ideas and thoughts.
- 1 Dev guide for newbies
- 2 Write a Clang plugin for ASCII art
- 3 Improve extensions/templates website
- 4 Improve HTML export further
- 5 Dev Intro ressources
- 6 Improve Python scripting situation
- 7 Improve macro info
- 8 Integrate the LO source code docs
- 9 Improve mkdocs
- 10 Put Vagrant to good use
- 11 Replace OpenGrok
- 12 Add term Pareto to chart types
- 13 Done
Dev guide for newbies
Aim: Create a walk-through-style guide on how to get from "I want to contribute code to LO" to "Thank you for your patch! It has been merged to LibreOffice."
Write a Clang plugin for ASCII art
LibO is riddeled with ASCII art. This needs to be removed.
So, write a Clang plugin for that. Start here
Improve extensions/templates website
The current (13/4/2012) state of the extensions website is regretful, especially when compared to what Mozilla has.
Luckily the publish their source code:
We currently use Plone and luckily it's also Python-based. Therefore a migration does not seem too hard.
- Shared maintenance cost with Mozilla people
- Have a great website to get started with
- Screenshots, ratings, featured content, categories, user pages, addon collections, recommendations, installation tips
- Provide an update mechanism for extensions
- Need to know Python & Django to do something (still need to see to what degree that is true)
- Does it respect different platforms?
- How does the update mechanism work? How does it compare to the LO way of doing things?
Improve HTML export further
Use Paul Rouget's  for HTML export. Make this an extension "HTML5 Slideshow export".
Dev Intro ressources
Some links for a better dev intro experience
Improve Python scripting situation
Next to JS, BeanShell and Basic, LO can be scripted through Python. Unfortunately, it's in dire need of improvement:
Hardly any learning resources available:
- The Macros page doesn't even list it as an option
- Lots of info still only available in OO.o-land (OO.o wiki, Forum post, Official OO.o wiki, ,SO post, Calc and Python)
Lacking integration into LO:
Python macros are not editable from within LO itself (!): see Tools -> Macros -> Organize Macros... (all useful buttons are just grayed out; not very user-friendly). See closed bug #56289 and related StackOverflow question
The scripts folder (for Linux in /opt/libreoffice4.2/share/Scripts/python) is not editable by the current user as it's the install folder. Which means we can't just open the default system text editor with the file.
- There is documentation (see above links)
- There are some snippets out there (Calc toolpanel SDK example)
- There is ooopy.sourceforge.net
- https://datanitro.com/ - Python for Excel
- https://github.com/jonathanslenders/python-prompt-toolkit - Interactive Python Shell Toolkit
Improve macro info
Current page (Macros) has some problems:
- Is it a general info page on LO Basic macros?
- Is a snippets collection (see other macro pages)?
- Where's the real documentation?
- Guides, intro and function/API documentation
Persona to think of:
- Joe Bloggs: Knows MS Office, heard about VBScripts (may have used them in the past). How does he script/use macros in LO?
- Issues within LO:
- Scripting vs. macro - what's the difference?
- No hint for multiple languages ...
- What's the learning path?
- How to cover other languages (esp. Python)?
- Major fault: Python scripts are not editable from within LO itself
- Issues outside LO:
- Where do I find examples? Where's the community?
- Do we need a code snippets sharing site? (se GitHub Gists?)
- How do we integrate with AOO? We're still relying *heavily* on their docs ...
Integrate the LO source code docs
Currently split between docs.lo.org and various other places.
No coherent style means unnecessary confusion.
Collect, make it fit together and stream line ux of it for new developer experience.
- Analyse content of READMEs
- Have in line code -> needs direct formatting
- Have references to cgit and Doxygen (and wiki)
- Convert all present docs to .md files manually (shouldn't be that many)
- Write template, based on the style of site
- Write a script to create the static site from the READMEs
- Finally: commit it to master and delete old READMEs
Find a way to run it regularly.
- No info on how to get started from a LO Basic point of view/how to use documentation (esp. Doxygen)
Add to body tag: `class="multi-col"`
Also: make header colour `#00A500`
- Add a doc info switcher
- Or just add docs links next to module name in overview?
- Move to Markdown or Wiki Text for READMEs:
- Still readable in ASCII alone
- Fixes ASCII art in https://docs.libreoffice.org/svx.html
- Fixes line broken endings
- Needs move to Python for mkdocs script (can be gradual)
- Or stick with bash https://github.com/chadbraunduin/markdown.bash
- Move info into LO wiki itself (replace/augment the code overview page)
- Improve exec of the tool (current snapshot is from 5/8 ...)
Put Vagrant to good use
See [www.vagrantup.com Vagrant website]
Still needs feature comparison and some discussion.
Add term Pareto to chart types
Currently called, Column and Line, but really is a Pareto chart. Correct that and make it easier to find.
Add Adobe .ase colour palette support
We currently only support the GIMP format; we should also support the (very popular) .ase format (as used by all Adobe products and kuler.adobe.com).
- Filed bug #84002
Use GDB dashboard for something fun.