Getting started with the desktop guide

[Doug Smythies]

On Sat, Mar 19, 2022 at 5:17 PM Jon Duncan <nmath at herofinn.com> wrote:
> ...
> I cloned both repos and poked around as you suggested.
>
> I have some working knowledge with git even though I have
> not used it very much in practice. I understand how a typical
> project is usually organized on git, and I know basic commands
> like how to clone, push, pull, commit, etc.
>
> I am less familiar with Mallard, but the documentation you
> linked is helpful. I have experience writing HTML, and the
> syntax and usage look similar to HTML and other markup
> languages I've worked with.
>
> I was able to make local changes to several .page files
> and preview them using yelp, so I don't think I'll encounter
> many problems making changes to preexisting documents.
>
> However, if it came to drafting an entirely new page, I would
> probably need some technical help, especially as it pertains
> to links and relationships to the rest of the documentation.

It is very rare that we add a page at this level, as preference
is to pull from upstream.

Anway, it is pretty easy. Have a look at commit 3f35562
for the most recent example I could find. i.e.

git show 3f35562

... Doug