From ale.comp_06 at xox.ch Sat May 4 02:41:43 2019 From: ale.comp_06 at xox.ch (ale rimoldi) Date: Sat, 4 May 2019 11:41:43 +0200 Subject: [FM Discuss] State of Libre Graphics 2019 Message-ID: <20190504114143.3c80ec38@scharfeis.home> Hi The Libre Graphics Meeting 2019 is just around the corner! (https://libregraphicsmeeting.org/2019/) As usual, the first conference will be the State of Libre Graphics, where we will give an overview of what has happened during the last year in the world of Libre Graphics: https://libregraphicsmeeting.org/2019/schedule-thur-30-05/ You're very welcome to submit three slides for your project. They will be presented by the moderator of the "State of Libre Graphics". Instructions for submitting the slides can be found in the Github repository that will contain all slides: https://github.com/libregraphicsmeeting/state-of-lg-2019/ Don't hesitate to open a ticket in the repository if you have further questions: https://github.com/libregraphicsmeeting/state-of-lg-2019/issues And, of course, you're very welcome to join us in Saarbr?cken! Ciao a.l.e From mick at flossmanuals.net Sun May 12 11:17:37 2019 From: mick at flossmanuals.net (mick at flossmanuals.net) Date: Sun, 12 May 2019 19:17:37 +0100 Subject: [FM Discuss] UK event linked to FLOSS Manuals coming up in June in UK In-Reply-To: References: Message-ID: <9007e41c-f254-6247-4dff-ef50807733b4@flossmanuals.net> Barncamp is a tech-focused skill-sharing event where over the course of a weekend, people converge to share ideas, projects and skills around digital citizenship and activism. It will take place this summer in a stunning location overlooking the Wye Valley in South Wales, from the 21st to the 23rd of June 2019. Tickets are ?40, payable in advance via this website https://barncamp.org.uk/. As well as a diverse range of talks and workshops, which in the past have ranged from digital forensics to foraging, a ticket includes a camping pitch, delicious vegetarian food and bargainous bar. It's a DIY event, and magic ingredient is you - your ideas and aspirations for an empowered digital citizenship, through talks, workshops and music. So when you sign up please let us know what you would like to offer to the event - be it leading a workshop, helping to set up & tat down, or simply helping out at the bar or the welcome desk. We are all crew. Children are welcome, especially those old enough to participate, but in the past there has not been much focus on children's activities, and child care has not usually been provided. Offers are always welcome of course! Any?questions,?email?barncamp2019 at hacktionlab.org Love, The?Barncamp?Collective -------------- next part -------------- An HTML attachment was scrubbed... URL: From scottwysocki at protonmail.com Sun May 12 13:16:37 2019 From: scottwysocki at protonmail.com (Scott Wysocki) Date: Sun, 12 May 2019 20:16:37 +0000 Subject: [FM Discuss] Introduction to the Community Message-ID: Hi there. My name is Scott and I'm a new contributor. I'd like to begin by working on the Introduction to the Command Line book. I don't know much about the command line, but I've always wanted to learn. I also want to improve my ability to write manuals. I'm going to use the manual to learn the command line, and, while doing so, I'll proofread it. I'm a credentialed English teacher and have done college writing tutoring, so I know a decent amount about writing. At this point, proofreading is all I feel comfortable doing, so if no one objects, that's what I'll work on. For those professional tech writers out there, I'd also love to have a mentor, so let me know if any of you would be willing to take me under your wing. I'm looking forward to getting to know the community. Thanks very much, Scott Wysocki -------------- next part -------------- An HTML attachment was scrubbed... URL: From dimonadelvere at outlook.com Mon May 13 03:39:54 2019 From: dimonadelvere at outlook.com (Dimona Delvere) Date: Mon, 13 May 2019 10:39:54 +0000 Subject: [FM Discuss] New Volunteer Message-ID: Hello Everyone, I am a new volunteer to FlossManuals and I have already signed to contribute to WordPress project. Please feel free to get in touch. Dimona -------------- next part -------------- An HTML attachment was scrubbed... URL: From mick at flossmanuals.net Mon May 13 21:36:40 2019 From: mick at flossmanuals.net (mick at flossmanuals.net) Date: Tue, 14 May 2019 05:36:40 +0100 Subject: [FM Discuss] Introduction to the Community In-Reply-To: References: Message-ID: <1c3d6363-1864-8226-014d-dfabd5dc14ca@flossmanuals.net> Hi Scott, Great to have you on board. Have you been in touch with Andy Oram yet who is heading up the Command Line efforts? As we imagined the traffic discussing this may be quite high to co-ordinate efforts.? We set up a separate email list for the project here.http://lists.flossmanuals.net/listinfo.cgi/cl-flossmanuals.net Also, as we've ironed out some wrinkles with the new FM write site (or more accurately one particular bug just stopped happening in a strange but fortuitous way) - and there are a few projects active now - I'll try to convene an open FM community meeting in the next month which may be of interest to you Scott and others who have joined the list in the last year where we've been in transition. Many Thanks Mick On 12/05/2019 21:16, Scott Wysocki wrote: > Hi there. My name is Scott and I'm a new contributor. I'd like to > begin by working on the Introduction to the Command Line book. I don't > know much about the command line, but I've always wanted to learn. I > also want to improve my ability to write manuals. I'm going to use the > manual to learn the command line, and, while doing so, I'll proofread > it. I'm a credentialed English teacher and have done college writing > tutoring, so I know a decent amount about writing. At this point, > proofreading is all I feel comfortable doing, so if no one objects, > that's what I'll work on. > > For those professional tech writers out there, I'd also love to have a > mentor, so let me know if any of you would be willing to take me under > your wing. > > I'm looking forward to getting to know the community. > > Thanks very much, > > Scott Wysocki > > > > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net - you can unsubscribe here -------------- next part -------------- An HTML attachment was scrubbed... URL: From M.Chesterman at mmu.ac.uk Mon May 13 22:08:28 2019 From: M.Chesterman at mmu.ac.uk (Mick Chesterman) Date: Tue, 14 May 2019 05:08:28 +0000 Subject: [FM Discuss] New Volunteer In-Reply-To: References: Message-ID: <1557810508335.8358@mmu.ac.uk> Wecome Dimona, Feel free to post updates and questions and questions for help / participation to this list. If there's lots of traffic then we can move it to a separate email list to save people's inboxes. Thanks Mick From: Discuss on behalf of Dimona Delvere Sent: 13 May 2019 11:39 To: discuss at lists.flossmanuals.net Subject: [FM Discuss] New Volunteer Hello Everyone, I am a new volunteer to FlossManuals and I have already signed to contribute to WordPress project. Please feel free to get in touch. Dimona "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 " -------------- next part -------------- An HTML attachment was scrubbed... URL: From mick at flossmanuals.net Tue May 14 01:11:15 2019 From: mick at flossmanuals.net (mick at flossmanuals.net) Date: Tue, 14 May 2019 09:11:15 +0100 Subject: [FM Discuss] When to use FLOSS Manuals and when it's not the best tool / platform? your opinions In-Reply-To: <1557810508335.8358@mmu.ac.uk> References: <1557810508335.8358@mmu.ac.uk> Message-ID: Hi there, For the FLOSS Manual Manual update, It would be great to get people's experiences of when a platform like BookType that FM uses is the best option for an individual to use for documentation, and when other tools are a better fit. Times have changed and when Adam Hyde FM started there was really nothing out there like it in terms of flexibility and ease of use for documentation. Now there are quite a few alternatives. * https://readthedocs.org/ (in combination with https://www.sphinx-doc.org/_ * git books - and git pages - https://www.gitbook.com/ * some kind of static site generator using Jamstack / Hugo / Jekyll or similar using mark-up source files * other solutions I'd be interested to know if people on this list who used to use FLOSS Manuals but now use something else would like to comment on the pros and cos. The purpose is to write a chapter that helps people evaluate if FM is the right place for them. Some of the factors might be... * ease of use, pros and cos of using WYSIWYG * limits to version control * translations * issues around communities and particular needs / expectations One thing, it would be great not to focus on past / current issues of using BookType. If you have bug reports or feature requests it would be great to put them here instead. https://gitlab.com/flossmanuals/fm_booktype But even if there's an overlap, then please chip in! nice one! Mick From scottwysocki at protonmail.com Tue May 14 14:21:31 2019 From: scottwysocki at protonmail.com (Scott Wysocki) Date: Tue, 14 May 2019 21:21:31 +0000 Subject: [FM Discuss] Discuss Digest, Vol 139, Issue 4 In-Reply-To: References: Message-ID: Thanks very much, Mick. I just emailed someone directly whose name was Mick and then received your message through the Digest almost immediately afterward. Perhaps the Mick I emailed was you. I haven't contacted Andy Oram yet. How can I find his email address? Thanks again! Scott ??????? Original Message ??????? On Tuesday, May 14, 2019 4:36 PM, wrote: > Hi Scott, > > Great to have you on board. Have you been in touch with Andy Oram yet who is heading up the Command Line efforts? > > As we imagined the traffic discussing this may be quite high to co-ordinate efforts. We set up a separate email list for the project here.http://lists.flossmanuals.net/listinfo.cgi/cl-flossmanuals.net > > Also, as we've ironed out some wrinkles with the new FM write site (or more accurately one particular bug just stopped happening in a strange but fortuitous way) - and there are a few projects active now - I'll try to convene an open FM community meeting in the next month which may be of interest to you Scott and others who have joined the list in the last year where we've been in transition. > > Many Thanks > Mick > > On 12/05/2019 21:16, Scott Wysocki wrote: > >> Hi there. My name is Scott and I'm a new contributor. I'd like to begin by working on the Introduction to the Command Line book. I don't know much about the command line, but I've always wanted to learn. I also want to improve my ability to write manuals. I'm going to use the manual to learn the command line, and, while doing so, I'll proofread it. I'm a credentialed English teacher and have done college writing tutoring, so I know a decent amount about writing. At this point, proofreading is all I feel comfortable doing, so if no one objects, that's what I'll work on. >> >> For those professional tech writers out there, I'd also love to have a mentor, so let me know if any of you would be willing to take me under your wing. >> >> I'm looking forward to getting to know the community. >> >> Thanks very much, >> >> Scott Wysocki >> >> _______________________________________________ >> Discuss mailing list >> Discuss at lists.flossmanuals.net >> >> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net >> - you can unsubscribe here > > Wecome Dimona, > > Feel free to post updates and questions and questions for help / participation to this list. > > If there's lots of traffic then we can move it to a separate email list to save people's inboxes. > > Thanks > > Mick > > From: Discuss on behalf of Dimona Delvere > > Sent: 13 May 2019 11:39 > To: discuss at lists.flossmanuals.net > Subject: [FM Discuss] New Volunteer > > Hello Everyone, > > I am a new volunteer to FlossManuals and I have already signed to contribute to WordPress project. > > Please feel free to get in touch. > > Dimona > "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 " -------------- next part -------------- An HTML attachment was scrubbed... URL: From M.Chesterman at mmu.ac.uk Tue May 14 23:46:24 2019 From: M.Chesterman at mmu.ac.uk (Mick Chesterman) Date: Wed, 15 May 2019 06:46:24 +0000 Subject: [FM Discuss] Discuss Digest, Vol 139, Issue 4 In-Reply-To: References: Message-ID: <1c7a47aeaecc4463b033d152e004bfb4@BFEX02.ad.mmu.ac.uk> Sorry Scott, I thought your original email was to the discuss list! I am the same Mick Ccing in Andy now! Mick From: Discuss On Behalf Of Scott Wysocki Sent: 14 May 2019 22:22 To: discuss at lists.flossmanuals.net Subject: Re: [FM Discuss] Discuss Digest, Vol 139, Issue 4 Thanks very much, Mick. I just emailed someone directly whose name was Mick and then received your message through the Digest almost immediately afterward. Perhaps the Mick I emailed was you. I haven't contacted Andy Oram yet. How can I find his email address? Thanks again! Scott ??????? Original Message ??????? On Tuesday, May 14, 2019 4:36 PM, > wrote: Hi Scott, Great to have you on board. Have you been in touch with Andy Oram yet who is heading up the Command Line efforts? As we imagined the traffic discussing this may be quite high to co-ordinate efforts. We set up a separate email list for the project here.http://lists.flossmanuals.net/listinfo.cgi/cl-flossmanuals.net Also, as we've ironed out some wrinkles with the new FM write site (or more accurately one particular bug just stopped happening in a strange but fortuitous way) - and there are a few projects active now - I'll try to convene an open FM community meeting in the next month which may be of interest to you Scott and others who have joined the list in the last year where we've been in transition. Many Thanks Mick On 12/05/2019 21:16, Scott Wysocki wrote: Hi there. My name is Scott and I'm a new contributor. I'd like to begin by working on the Introduction to the Command Line book. I don't know much about the command line, but I've always wanted to learn. I also want to improve my ability to write manuals. I'm going to use the manual to learn the command line, and, while doing so, I'll proofread it. I'm a credentialed English teacher and have done college writing tutoring, so I know a decent amount about writing. At this point, proofreading is all I feel comfortable doing, so if no one objects, that's what I'll work on. For those professional tech writers out there, I'd also love to have a mentor, so let me know if any of you would be willing to take me under your wing. I'm looking forward to getting to know the community. Thanks very much, Scott Wysocki _______________________________________________ Discuss mailing list Discuss at lists.flossmanuals.net http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net - you can unsubscribe here Wecome Dimona, Feel free to post updates and questions and questions for help / participation to this list. If there's lots of traffic then we can move it to a separate email list to save people's inboxes. Thanks Mick From: Discuss > on behalf of Dimona Delvere > Sent: 13 May 2019 11:39 To: discuss at lists.flossmanuals.net Subject: [FM Discuss] New Volunteer Hello Everyone, I am a new volunteer to FlossManuals and I have already signed to contribute to WordPress project. Please feel free to get in touch. Dimona "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 " -------------- next part -------------- An HTML attachment was scrubbed... URL: From maren at goos-habermann.de Wed May 15 15:06:10 2019 From: maren at goos-habermann.de (Maren Hachmann) Date: Thu, 16 May 2019 00:06:10 +0200 Subject: [FM Discuss] When to use FLOSS Manuals and when it's not the best tool / platform? your opinions In-Reply-To: References: <1557810508335.8358@mmu.ac.uk> Message-ID: Hi Mick, I'm still following this list, even though I have switched to using sphinx/readthedocs some time ago, and I'm happy to help you, and to help the users to make a good decision. Strengths of Booktype: * easy to use for people who are not accustomed to write html or any markup language, and cannot or don't want to invest time into learning it, but get working on the content * built-in community platform to facilitate exchange between editors * a large community around it and people who 'randomly' come and ask if they can help (for Flossmanuals) Strengths of RTD/Sphinx: * less fragmentation between the communication channels of a project * full control over layout (you have that, too, if you're an admin of a booktype instance, but not as a Flossmanuals user) * semantic markup (i.e. the markup that is used does not only have a style, but also an inherent meaning, like keyboard shortcuts, glossary entries, code snippets, menu entries etc.) * version control that allows you to not just view previous states, but also combine them and going back to them, deciding what you want to keep and what not * plaintext files that are accessible as a whole, so things like search and replace over a larger corpus will work * a rudimentary system to enable translations (it doesn't use po files, as far as I know, but it will keep translations together with the rest as a single project, and they can be made available as translations to select from If I had to describe use cases, I would say that flossmanuals is better for shorter prose-like manuals which are written by people of varying technical skill level, and who do not have time or energy to invest into preparations. It can be useful to get unexpected help from writers who need experience for their CV or for study-related projects. Also, these are more self-contained projects that are not part of a larger project, and don't need to integrate with that project's existing infrastructure. I think a text-file-based and version-controlled system is better for larger corpora and technically versed authors/admins who want a high degree of customizability and have the skills to implement that. If a git and communication infrastructure exists and is used extensively already, it can help to keep things together more easily. (I also really didn't like how BookType worked with images, it was a pain to just exchange one - also that the last time I used it, it didn't support SVG.) Hope this helps, Kind Regards Maren Am 14.05.19 um 10:11 schrieb mick at flossmanuals.net: > Hi there, > > For the FLOSS Manual Manual update, It would be great to get people's > experiences of when a platform like BookType that FM uses is the best > option for an individual to use for documentation, and when other tools > are a better fit. > > Times have changed and when Adam Hyde FM started there was really > nothing out there like it in terms of flexibility and ease of use for > documentation. Now there are quite a few alternatives. > > * https://readthedocs.org/ (in combination with https://www.sphinx-doc.org/_ > * git books - and git pages - https://www.gitbook.com/ > * some kind of static site generator using Jamstack / Hugo / Jekyll or > similar using mark-up source files > * other solutions > > I'd be interested to know if people on this list who used to use FLOSS > Manuals but now use something else would like to comment on the pros and > cos. The purpose is to write a chapter that helps people evaluate if FM > is the right place for them. Some of the factors might be... > > * ease of use, pros and cos of using WYSIWYG > * limits to version control > * translations > * issues around communities and particular needs / expectations > > One thing, it would be great not to focus on past / current issues of > using BookType. If you have bug reports or feature requests it would be > great to put them here instead. > https://gitlab.com/flossmanuals/fm_booktype > > But even if there's an overlap, then please chip in! > > nice one! > > Mick > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net - you can unsubscribe here > -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 833 bytes Desc: OpenPGP digital signature URL: From gpittman at iglou.com Wed May 15 17:38:37 2019 From: gpittman at iglou.com (Gregory Pittman) Date: Wed, 15 May 2019 20:38:37 -0400 Subject: [FM Discuss] When to use FLOSS Manuals and when it's not the best tool / platform? your opinions In-Reply-To: References: <1557810508335.8358@mmu.ac.uk> Message-ID: <51c22e58-41b1-84e9-34c4-6b848206d61e@iglou.com> On 5/15/19 6:06 PM, Maren Hachmann wrote: > Hi Mick, > > I'm still following this list, even though I have switched to using > sphinx/readthedocs some time ago, and I'm happy to help you, and to help > the users to make a good decision. > At least what I can quickly poke away at with sphinx/RTD, it looks exactly what I don't like about formatting documentation/books -- a lot of lingo to learn, and more or less programming. If I wanted that, I would stick with TeX, which I already have some experience with. Booktype in the past has been easy to use, and has and more intuitive interface. The problems I have had recently is that it seems to be broken for turning your documents into something useful, like ePubs or PDFs. I tried writing a manual and ended up scraping out the raw material and making my PDF with Scribus, where at least I felt I had control of the layout. The problem with TeX is its handling of images, which as far as I know still remains rather clumsy, but if you don't need images, and like the automatic way of creating footnotes, endnotes, and tables, and well at math symbols, it can be useful. What one wants to achieve is something that can handle both the production of rigid sorts of layouts like PDF and also the more flexible needs of ePubs. Greg From mick at flossmanuals.net Thu May 16 02:04:51 2019 From: mick at flossmanuals.net (mick at flossmanuals.net) Date: Thu, 16 May 2019 10:04:51 +0100 Subject: [FM Discuss] When to use FLOSS Manuals and when it's not the best tool / platform? your opinions In-Reply-To: <51c22e58-41b1-84e9-34c4-6b848206d61e@iglou.com> References: <1557810508335.8358@mmu.ac.uk> <51c22e58-41b1-84e9-34c4-6b848206d61e@iglou.com> Message-ID: Thanks Maren and Greg, These are both very detailed and valuable insights. :) In fact this can be useful not only in helping people to choose the right platform/ community for them, but also to help us develop an online community practice too.? nice one Mick On 16/05/2019 01:38, Gregory Pittman wrote: > On 5/15/19 6:06 PM, Maren Hachmann wrote: >> Hi Mick, >> >> I'm still following this list, even though I have switched to using >> sphinx/readthedocs some time ago, and I'm happy to help you, and to help >> the users to make a good decision. >> > At least what I can quickly poke away at with sphinx/RTD, it looks exactly what I don't like about formatting documentation/books -- a lot of lingo to learn, and more or less programming. If I wanted that, I would stick with TeX, which I already have some experience with. From helen at creative-catalyst.com Fri May 17 01:28:06 2019 From: helen at creative-catalyst.com (Helen Varley Jamieson) Date: Fri, 17 May 2019 10:28:06 +0200 Subject: [FM Discuss] When to use FLOSS Manuals and when it's not the best tool / platform? your opinions In-Reply-To: <832f4c13-af2e-e4e6-9c3b-3eceedb0463b@flossmanuals.net> References: <832f4c13-af2e-e4e6-9c3b-3eceedb0463b@flossmanuals.net> Message-ID: <15c9a3c8-4092-945e-9491-d6b1f7da1efc@creative-catalyst.com> hi mick, & everyone :) we are still using UpStage v3 & still using the manual, even though it's out of date & i simply have no time to update it ... we are now (slowly!) working on a complete rebuild of the platform, which is going to result in the need for a completely new manual, but until we are much further along with that we aren't ready to start the manual. (in case anyone on this list is interested, see https://upstage.org.nz/ and https://github.com/upstage-org/limelight) this chapter is an important one to have in the manual, right up front. for me i would say that the two most important reasons for using FM have been around remote collaboration - since our community are all over the world, it's important to have one central editable repository for the manual that multiple people can easily access and edit. & the other is accessibiliity - it's easy to share the link, to download as pdf or print out for workshop situations, & generally easy for complete newbies to find the information they need in the manual. in this respect it's better than wikis, which are not so easy to print out sections from (in my experience) & can sometimes be off-putting to less geeky people, for both reading & editing. other than that, the community around FM is important for me as an editor; being able to ask questions & get support & importantly to be involved in the platform itself - owning our tools is important for me, & as awareness grows around the politics of tech giants i hope this will be important for more people out there. h : ) > > Hi there, > > For the FLOSS Manual Manual update, It would be great to get people's > experiences of when a platform like BookType that FM uses is the best > option for an individual to use for documentation, and when other tools > are a better fit. > > Times have changed and when Adam Hyde FM started there was really > nothing out there like it in terms of flexibility and ease of use for > documentation. Now there are quite a few alternatives. > > * https://readthedocs.org/ (in combination with > https://www.sphinx-doc.org/_ > * git books - and git pages - https://www.gitbook.com/ > * some kind of static site generator using Jamstack / Hugo / Jekyll or > similar using mark-up source files > * other solutions > > I'd be interested to know if people on this list who used to use FLOSS > Manuals but now use something else would like to comment on the pros and > cos. The purpose is to write a chapter that helps people evaluate if FM > is the right place for them. Some of the factors might be... > > * ease of use, pros and cos of using WYSIWYG > * limits to version control > * translations > * issues around communities and particular needs / expectations > > One thing, it would be great not to focus on past / current issues of > using BookType. If you have bug reports or feature requests it would be > great to put them here instead. > https://gitlab.com/flossmanuals/fm_booktype > > But even if there's an overlap, then please chip in! > > nice one! > > Mick > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net - > you can unsubscribe here -- helen varley jamieson helen at creative-catalyst.com http://www.creative-catalyst.com http://www.upstage.org.nz -------------- next part -------------- An HTML attachment was scrubbed... URL: From deanna.thompson45 at outlook.com Mon May 27 16:19:22 2019 From: deanna.thompson45 at outlook.com (Deanna Thompson) Date: Mon, 27 May 2019 23:19:22 +0000 Subject: [FM Discuss] New volunteer Message-ID: Hi all, I am an English instructor looking to gain experience writing technical documentation. Looking to help with writing, editing, and proofreading manuals. Feel free to reach out! Thanks, Deanna Deanna Thompson English Instructor -------------- next part -------------- An HTML attachment was scrubbed... URL: From mick at flossmanuals.net Tue May 28 03:22:00 2019 From: mick at flossmanuals.net (mick at flossmanuals.net) Date: Tue, 28 May 2019 11:22:00 +0100 Subject: [FM Discuss] New volunteer In-Reply-To: References: Message-ID: Hi there Deanna, There's a Wordpress rewrite going on which Dimona is heading up. Invite code is here. 54EB4D0B https://en.flossmanuals.net/wordpressnew/_info/ If you want to start a new book let me know and let me know the name and URL and I'll get it set up for you. (sorry it's about spam issues!) I'm hoping to get a version of this ready for proofing soon. I thought I'd finished it ages ago but I was very wrong! https://en.flossmanuals.net/phaser-game-making-in-glitch/_full/ Thanks Mick On 28/05/2019 00:19, Deanna Thompson wrote: > Hi all,? > > I am an English instructor looking to gain experience writing > technical documentation. ?Looking to help with writing, editing, and > proofreading manuals. Feel free to reach out! ? > > Thanks, Deanna > > > > Deanna Thompson > English Instructor > > > > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net - you can unsubscribe here -------------- next part -------------- An HTML attachment was scrubbed... URL: From mick at flossmanuals.net Tue May 28 03:47:46 2019 From: mick at flossmanuals.net (mick at flossmanuals.net) Date: Tue, 28 May 2019 11:47:46 +0100 Subject: [FM Discuss] New volunteer In-Reply-To: References: Message-ID: <756ae105-ad9a-b0f6-e73b-d4bad745a212@flossmanuals.net> Hi there, Deanna, Another thought. We also need help on writing a user guide for FLOSS Manuals too. https://en.flossmanuals.net/floss-manuals/_info/ Invite code here - F82F2A56 There are some notes here on planned changes but feel free to ask questions on this email list. https://public.etherpad-mozilla.org/p/fm_manual Thanks Mick On 28/05/2019 00:19, Deanna Thompson wrote: > Hi all,? > > I am an English instructor looking to gain experience writing > technical documentation. ?Looking to help with writing, editing, and > proofreading manuals. Feel free to reach out! ? > > Thanks, Deanna > > > > Deanna Thompson > English Instructor > > > > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net - you can unsubscribe here -------------- next part -------------- An HTML attachment was scrubbed... URL: From mick at flossmanuals.net Tue May 28 03:56:43 2019 From: mick at flossmanuals.net (mick at flossmanuals.net) Date: Tue, 28 May 2019 11:56:43 +0100 Subject: [FM Discuss] When to use FLOSS Manuals and when it's not the best tool / platform? your opinions In-Reply-To: References: Message-ID: <25a23769-d454-8f49-5529-17618702e201@flossmanuals.net> Hi there, I'm compiling these replies to help with the new intro for the FM manual. I had a comment in relation to this one. "Michael, I imagine there is something about the familiarity of contributing 'code' / docs? via a git pull request -- for those familiar with the process -- which for many may be less intimidating than the social process of reaching out to an unknown community on an email list or forum, or just getting stuck in" nice one Mick > On 16/05/2019 20:00, michaelmcandrew at thirdsectordesign.org wrote: >> Hey Mick, >> >> Nice to hear from you. CiviCRM 'abandoned' FM a few years ago (sorry >> about that!) in favour of read the docs based on markdown in git repos. >> >> git and markdown is significantly more techy and while this might >> have prevented a few non technical people from contributing, the >> number and quality of our contributions to documentation has >> increased considerably - that's the nature of our community, I guess. >> >> Also, I use jekyll for company and personal documentation. I love the >> simplicity and flexibility. >> >> Hope you are well and that that is somewhat useful. >> >> Michael >> >> On Tue, 2019-05-14 at 09:24 +0100, mick at flossmanuals.net wrote: >>> >>> >>> -------- Forwarded Message -------- >>> Subject: [FM Discuss] When to use FLOSS Manuals and when it's not >>> the best tool / platform? your opinions >>> Date: Tue, 14 May 2019 09:11:15 +0100 >>> From: mick at flossmanuals.net >>> Reply-To: discuss at lists.flossmanuals.net >>> To: discuss at lists.flossmanuals.net >>> >>> >>> >>> Hi there, >>> >>> For the FLOSS Manual Manual update, It would be great to get people's >>> experiences of when a platform like BookType that FM uses is the best >>> option for an individual to use for documentation, and when other tools >>> are a better fit. >>> >>> Times have changed and when Adam Hyde FM started there was really >>> nothing out there like it in terms of flexibility and ease of use for >>> documentation. Now there are quite a few alternatives. >>> >>> * https://readthedocs.org/ (in combination with >>> https://www.sphinx-doc.org/_ >>> * git books - and git pages - https://www.gitbook.com/ >>> * some kind of static site generator using Jamstack / Hugo / Jekyll or >>> similar using mark-up source files >>> * other solutions >>> >>> I'd be interested to know if people on this list who used to use FLOSS >>> Manuals but now use something else would like to comment on the pros and >>> cos. The purpose is to write a chapter that helps people evaluate if FM >>> is the right place for them. Some of the factors might be... >>> >>> * ease of use, pros and cos of using WYSIWYG >>> * limits to version control >>> * translations >>> * issues around communities and particular needs / expectations >>> >>> One thing, it would be great not to focus on past / current issues of >>> using BookType. If you have bug reports or feature requests it would be >>> great to put them here instead. >>> https://gitlab.com/flossmanuals/fm_booktype >>> >>> But even if there's an overlap, then please chip in! >>> >>> nice one! >>> >>> Mick -------------- next part -------------- An HTML attachment was scrubbed... URL: From helen at creative-catalyst.com Tue May 28 06:49:30 2019 From: helen at creative-catalyst.com (Helen Varley Jamieson) Date: Tue, 28 May 2019 15:49:30 +0200 Subject: [FM Discuss] =?utf-8?q?Libre_Graphics_Meeting_-_this_week_in_Saar?= =?utf-8?q?br=C3=BCcken?= Message-ID: hi, is anyone else on this list going to be at the Libre Graphics Meeting in Saarbr?cken, starting tomorrow evening? i'll be there, leading a BoF session about life cycles & sustainability of open source arts / community / social software on thursday afternoon. it would be great to say hello to any other FM folks that are there. h : ) -- helen varley jamieson helen at creative-catalyst.com http://www.creative-catalyst.com http://www.upstage.org.nz -------------- next part -------------- An HTML attachment was scrubbed... URL: From ms.paulalast at gmail.com Thu May 30 11:36:07 2019 From: ms.paulalast at gmail.com (Paula Last) Date: Thu, 30 May 2019 14:36:07 -0400 Subject: [FM Discuss] new contributor Message-ID: Hi everyone, I'm a content writer and recently got my certification in Technical Communications. My portfolio is mostly web content, I'm here to build my technical writing portfolio. I'd like to start by writing manuals/instructions for software. If there's a project that needs some help, feel free to let me know. Paula -------------- next part -------------- An HTML attachment was scrubbed... URL: