Hi Sean,
I believe 3) is the easiest option for non trivial changes. The github
UI is fine for quick edits (and lowers the barrier) but having a local
repo and branches is more flexible for more serious edits. This probably
also solves 1) for you since images are just files.
e.g this PR added a screenshot:
https://github.com/apache/netbeans-website/pull/640/files
I don't know why AsciiDoc is used, possibly because it was easier to
convert the old wiki into this? To me it all looks the same :)
best regards,
michael
On 25.02.23 14:55, Sean Carrick wrote:
Hey All,
I reviewed the File Templates Tutorial the other day and updated the
/TemplateRegistration/ and /NbBundle.Messages/ information in that
tutorial to point to their current locations (since NB8.2). Now, I'm a
little bit fired up to start reviewing more of those tutorials, so I
need to know some things in order to do this properly...
1. When reviewing them, will I be able to place a screenshot on my
clipboard and paste it into the document in the GitHub editor and
it be automatically uploaded like working in Markdown?
1. If not, will I need elevated permissions on the Repo to upload
the screenshots?
2. Curiosity: Why is AsciiDoc being used instead of Markdown?
3. Would y'all prefer I fork the repository and work on it that way,
or work directly in the repo like I did for the File Templates
Tutorial?
I am thinking that I will just start at the top of the
https://netbeans.apache.org/help/index.html Learning Trails and work
my way straight down all of the tutorials, if that is OK. I'll
probably get started working on this today, if no one has any objections.
I'll wait a couple hours before I start to give y'all time to respond.
And, I'll keep my eye on this message thread for the next few
days/weeks/months for any guidance that you may provide.
-SC
