ScientificPublishing / SciPub

2 stars 0 forks source link

Tutorials for MacOS and Windows Users #9

Open artydont opened 1 year ago

artydont commented 1 year ago

When we get going and have clear project documents explaining what we are doing and how, we will need to attract both developers who can help with software and others interested in helping process particular publications, produce bibliographies and glossaries, do annotations etc.

Many of the non-developers will be completely unfamiliar with using github and using the Terminal command line on their Windows and Macintosh computers.

We will need to provide onboarding tutorials for those people.

I suggest that @Ted1307 should start producing a tutorial for MacOS users and then others should adapt it for Windows users and/or a combined tutorial with separate supplements for MacOS and Windows.

People who already know forget what has to be explained to people who don't.

So the best people to write such tutorials are people who are learning how now.

In particular everybody participating will need to know:

  1. How to install Zotero and Joplin and read their documents.
  2. How to write and subscribe to Issues on GitHub (which uses Markdown).
  3. How to write a tutorial or other document in a GitHub repo either directly or editing offline in Joplin then adding to the repo.

Having already opened an Issue here also implies having already started to use Markdown. Switching between the Write and Preview tabs shows the effect of the icons for Boldface etc.

MacOS users will need to know:

  1. How to use the browser to find advice on all the questions below.
  2. How to open a Terminal and use the command line.
  3. How to install HomeBrew to get easy access to any free software.
  4. How to find and install necessary software using HomeBrew (eg a reader for .djvu files or convert them to .pdf files).

Then we will also need tutorials on how to do the bibliography processing we are already doing.