xaml-math
xaml-math copied to clipboard
Documentation for contributors
Clarify, please. What kind of documentation do our contributors need?
Okay, I'll try to elaborate myself.
We need sort of architectural document that will describe the current structure of the project. Major topics include:
- [ ]
TexRenderer
and its' basic usage - [ ]
TexFormulaParser
- [ ]
Atom
s - [ ]
Box
es - [ ] Styles
- [x] Fonts:
DefaultTexFont.xml
and how it's related withFonts/c*10.ttf
files (subject of ongoing research; see #70) - [ ] Fonts:
TexFont
vsSystemFont
dualism - [ ]
PredefinedTexFormulas.xml
and its' relation toTexFormulaHelper
through reflection - [ ] any other XML files not listed above
- [ ]
Rendering
namespace: current renderer implementation, detailed interface description - [ ] unit tests
For now, I have knowledge for most of the topics above with notable exception of XML files (I've no idea how are they created but we're trying to research it more), so I could become the main device behind documenting the stuff.
I suggest myself and other potential contributors to make small PRs for each of the topics (because it'll be easier to prepare and review). We'll close this task after all topics listed above are covered by the documentation. It's advisable to document new features as they come (although that shouldn't be a mandatory requirement for contributors to document it themselves).
FYI I'm currently rewriting this in F#, as a personal project to be able to understand the code and subsequently make the TeX editable. I don't know if I will succeed as the code is at first glance very OO, cyclic and imperative. But there may be a linear structure underlying it. If I do have some success you may be interested as I notice that everyone contributing seems to know F#. Help would be much appreciated as I am likely to have a lot of questions, mostly about the basic structure and meanings of the objects in your list, but also about some ideas for simplification.
@charlesroddie I've decided to move the discussion about F# port to another issue: #111.
And feel free to ask questions disregard we decide to port the code to F# or not; in any case, I'll be happy to (try to) answer any your questions about the project code.
If the documentation were to be created(or initialized), would you want it as a PDF, html or rst file?.
@B3zaleel I'd prefer markdown.
We have already started writing the documentation in markdown format. So, yeah, it's definitely a good choice for a project hosted on GitHub.