[FM Discuss] Hi folks

[Maren Hachmann]

Hey there,

the Inkscape Beginners' Guide *is* official, as stated in my previous
message :)
Gifs (as described in that same message - maybe you didn't get it?) are
a possible solution for having at least basic usage descriptions. They
can't be very complex, but even the short animations are already very
useful. But they don't work in print (and also not (yet?) in pdf), of
course. I'm not sure if they'd play if included in a booktype html
manual (in theory, they should, but who knows if it does any image
postprocessing).

Kind Regards,
 Maren

Am 04.01.2018 um 22:04 schrieb M R:
> Mick (and all):
> 
> 
> That certainly makes sense.  One thing that strikes me when I consider
> the concrete examples offered so far is that so many of them are
> centered on/driven by the needs of the FM contributors themselves (like
> you guys, but also going back to the founding), rather than hypothetical
> end-users outside of a specific context like the contributors'
> own teaching/workshops or other needs.  Which is completely fine AFAIAK,
> since my own interest would be largely selfish -- I want manual-writing
> practice and portfolio samples 😊; and if anyone else can get some use
> out of my contribution, that's great too.  It does appear that the
> situation is a bit different for software like Inkscape (vs Audacity or
> Blender, or Unity, or Firefox) because Inkscape's own site appears to
> endorse the Floss manual as semi-official.  So Inkscape might be the
> perfect example of a Floss manual where end-user utility is maximized.
> 
> 
> At the same time, it's also interesting that Inkscape's own site, in
> their 'Learning' tab, leans heavily as well on tutorials contributed by
> individuals in the user community, many of which are in video format. 
> Actually, I'm not aware of any software site (certainly in the graphics
> world), whether open-source or proprietary, that doesn't make heavy use
> of video tutorials, however rich the text documentation is.  I think
> this just speaks to a current diversity (maybe a transition -- we'll
> see) in end-user preferred learning modes.  Now, for an open-source,
> collaborative framework like Floss, I would say your other point (Mick)
> is probably decisive: the text-and-screenshot type of manual is easily
> remixed/edited/updated, which is essentially impossible in video
> tutorials (except for wholesale replacement/update by the original
> maker, which is what ends up happening in practice).   This isn't just
> about a difference in presentation technology, but about a fundamental
> difference in genre: traditional manuals, like all traditional tech
> writing, are intended to be anonymous, or neutrally voiced, such that
> any individual's contribution (given reasonable quality standards)
> should be transparent and interchangeable.  Whereas the (literal)
> narrative 'voice' of a video tutorial is not only irreducibly singular,
> personal, non-anonymous; that's also precisely what makes them
> *engaging* for people who prefer to learn that way.  
> 
> 
> I do wonder about a future (or on-going) convergence of the two modes:
> for instance many video tutorials are quite short now, focusing on very
> specific operations in a tool (even if they're then linked into longer
> series), which makes them more useful to a broader user base.  I think
> if I were designing a text-based static manual from scratch, now--at
> least for software that featured complex GUI operations---I'd
> probably want every section to at least include curated links to such
> short vid tutorials or demonstrations (even if I had to generate some of
> these myself).  But this already violates the anonymity principle...and
> at the same time it doesn't, IMO, go nearly far enough for some of the
> software uses I imagine documenting.  Blender, for instance, is a 3D
> modeling tool that relies on such complex and finicky GUI operations
> that a series of text instructions and screenshots would, I think, be
> hopelessly inadequate to convey how to actually use it.   There's still
> absolutely a place for textual Blender documentation, but I think it's
> more in the way of a reference dictionary than a manual as such.  I even
> feel this way about Audacity.  It's orders of magnitude less
> complex-finicky in its GUI than Blender, but if I wanted to convey how
> to do any kind of multi-track sound mixing and editing in order to build
> up an interesting sound-scape (and this is another document example I'm
> actively considering), I can't imagine doing this in any way but video. 
> Again, though, this may simply speak to the way I personally have been
> learning software (and on a largely hobbyist basis, at that) for the
> past decade.  
> 
> 
> I would be very interested, anyway, to see if anyone had come up with a
> framework for anonymized, open-source video tech documentation. 
> Actually you could sort of do it with a tool like Adobe Captivate, using
> their 'software demonstration' mode and maybe a text-to-voice feature. 
> Ok, nevermind...
> 
> 
> Matt
> 
> 
> 
> ------------------------------------------------------------------------
> *From:* Discuss <discuss-bounces at lists.flossmanuals.net> on behalf of
> Mick Chesterman <M.Chesterman at mmu.ac.uk>
> *Sent:* Thursday, January 4, 2018 2:04 AM
> *To:* discuss at lists.flossmanuals.net
> *Subject:* Re: [FM Discuss] Hi folks
>  
> Hi there,
> 
> I've got different hats on here.
> But one of my aims is to involve some of my University students in
> making manuals as a really productive learning activity.
> 
> So that's another reason to lower the barriers to contributions via text
> and screenshot being the basis rather than video. And the ease of
> remixing / updating.
> 
> Thanks
> Mick
> 
>> -----Original Message-----
>> From: Discuss [mailto:discuss-bounces at lists.flossmanuals.net] On Behalf Of
>> Maren Hachmann
>>
> 
> "Before acting on this email or opening any attachments you should read
> the Manchester Metropolitan University email disclaimer available on its
> website http://www.mmu.ac.uk/emaildisclaimer "
> _______________________________________________
> Discuss mailing list
> Discuss at lists.flossmanuals.net
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net -
> you can unsubscribe here
> 
> 
> _______________________________________________
> Discuss mailing list
> Discuss at lists.flossmanuals.net
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net - you can unsubscribe here
>