[OSM-talk] Help needed: OBS tutorial for Windows and Mac

[stevea]

Coming from someone with cross-platform experience and technical writing skills similar to what I understand Cassandra is asking, I'd say a good start would be a tutorial on how to INSTALL the different flavors of OBS for each supported operating system (Windows, Linux, macOS).  Make a pointer to the "install page," instruct that you can choose three (or more, sometimes a different version is required for an older OS, like Windows 7 and 10 might have different versions, or 10.15 being 64-bit only, maybe 10.14 down 10.6.8 would be supported for a 32-bit version, or "yes on Ubuntu of a particular version or later, but if you run Red Hat, you must have blah, blah"...) installer packages.

Then give instructions on each, even if it is "double-click the installer" (or invoke it from a command line like "this") and watch as people play with it and begin to make submissions of completed (or partially completed) presentations.  If the software has some built-in Help System (I haven't looked), installation instruction may be all that's required.  They are certainly a good start, if they don't already exist on the OBS download page (I haven't looked).

Guidelines (as to length) or templates (like a themed border-slide that has the SotM 2020 logo, for example) are helpful things to add which promote consistency, but these are not absolutely required.

Doing my best to help,

SteveA
California

> On Apr 5, 2020, at 12:33 PM, Frederik Ramm <frederik at remote.org> wrote:
> 
> Cassandra,
> 
> On 4/5/20 21:28, Cassandra McCarthy wrote:
>> I have a Windows install. Should I basically recreate the linked
>> tutorial, but for Windows?
> 
> I cannot say how big the differences are. If it's "basically the same"
> in Windows then it might be better to add comments to the existing
> tutorial (I did it in my user space because I wasn't sure what the final
> location should be - don't shy away from editing in my user space). If,
> on the other hand, things are vastly different on Windows to the point
> that the tutorial I made will confuse people more than it's good, then
> by all means do a separate tutorial!
> 
> Bye
> Frederik
> 
> -- 
> Frederik Ramm  ##  eMail frederik at remote.org  ##  N49°00'09" E008°23'33"
> 
> _______________________________________________
> talk mailing list
> talk at openstreetmap.org
> https://lists.openstreetmap.org/listinfo/talk