Hi, team. I uploaded the raw HTML version of the Ubuntu Studio Audio Handbook here: Re: [ubuntu-studio-devel] Ubuntu Studio For Musicians here: https://drive.google.com/open?id=1S5reUE9H0STDpo2zkHczsNseNBLinHul
The files are named with chapter number followed by chapter title. Also included: - Appendix - Table of Contents, linked to chapters - images directory - css file for callouts - header file - not currently implemented I made many edits, making this version significantly improved over the PDF. Can someone now post this somewhere on the documentation site for testing and review? It needs to be checked for: Accuracy - are the instructions correct? Any other factual errors? Typos? Clarity - are the instructions easy to follow? Depth - is any section in need of further elaboration? Should anything be dropped? Style - I removed some personal pronouns, but there's still a lot of first person statements, opinion, etc. Any other style changes needed? Thoughts on mention of commercial products? I have a short list of things I'd like to add or expand. Probably best to hold off working on it until it can be posted where anyone can edit it. If you have already gone through the PDF, you'll see this version is better. I would like to know: Does documentation go through review? Who are the gatekeepers? Can this be added to the existing, linked documentation outline? If not, where should it be posted? If there is other documentation, I have not been able to find it (other than the Ardour manual and the few pages on the home page). Could you send a link? These are raw HTML files. Is there an existing CSS stylesheet? If not, can someone help format it? I made the header a separate document so it could be included - what's the best way to implement that? Looking forward to your feedback. Pete On Sun, Jun 3, 2018 at 9:09 PM, < ubuntu-studio-devel-requ...@lists.ubuntu.com> wrote: > Send ubuntu-studio-devel mailing list submissions to > ubuntu-studio-devel@lists.ubuntu.com > > To subscribe or unsubscribe via the World Wide Web, visit > https://lists.ubuntu.com/mailman/listinfo/ubuntu-studio-devel > or, via email, send a message with subject or body 'help' to > ubuntu-studio-devel-requ...@lists.ubuntu.com > > You can reach the person managing the list at > ubuntu-studio-devel-ow...@lists.ubuntu.com > > When replying, please edit your Subject line so it is more specific > than "Re: Contents of ubuntu-studio-devel digest..." > > > Today's Topics: > > 1. Re: Ubuntu Studio For Musicians handbook > (lukefro...@hushmail.com) > 2. Re: Ubuntu Studio For Musicians (Peter Reppert) > 3. Re: Saturday's Meeting (June 2, 2018) (Erich Eickmeyer) > 4. Re: Saturday's Meeting (June 2, 2018) (Charlie) > > > ---------------------------------------------------------------------- > > Message: 1 > Date: Sun, 03 Jun 2018 17:54:23 -0400 > From: lukefro...@hushmail.com > To: "Ubuntu Studio Development" <ubuntu-studio-devel@lists.ubuntu.com> > Subject: Re: [ubuntu-studio-devel] Ubuntu Studio For Musicians > handbook > Message-ID: <20180603215423.ed877e0...@smtp.hushmail.com> > Content-Type: text/plain; charset="UTF-8" > > I am not on that list and will not be pursuing this matter any farther. > > > > >Luke, > > > >I understand your frustrations on this, but I'm afraid it will > >fall on > >deaf ears in this mailing list since the issues don't seem to be > >specific to Ubuntu Studio. > > > >Peter can correct me if I'm wrong, but I would say technical stuff > >like > >that is far beyond the scope of this handbook. It might seem like > >something easy to teach but in reality, it's not. I will say, > >however, > >that there can be an area on the wiki for that, although, since > >it's not > >Ubuntu Studio specific and applies to Ubuntu as a whole, it should > >be > >included in the main Ubuntu wiki. > > > >Remember, Ubuntu Studio is, to put it simply, a customized version > >of > >Ubuntu. Under-the-hood things like UEFI, BIOS, and other items are > >not > >within the scope of the Ubuntu Studio development team. For those > >things, there's the main ubuntu-devel mailing list. > > > >The scope of the Ubuntu Studio development team consists of the > >ubuntustudio-* packages primarily. We do not develop Ubiquity (the > >Ubuntu installer program). It is developed by the main Ubuntu > >development team. > > > >Also, and I cannot emphasize this enough, none of the Ubuntu Studio > >developers are paid to do this. It is a completely volunteer > >project. > > > >With that said, Luke, please take these frustrations to the ubuntu- > >devel > >mailing list so that the main Ubuntu Development team can have a > >go to > >address these issues. > > > > > >Erich > > > > > ------------------------------ > > Message: 2 > Date: Sun, 3 Jun 2018 18:26:09 -0400 > From: Peter Reppert <prepp...@gmail.com> > To: ubuntu-studio-devel@lists.ubuntu.com > Subject: Re: [ubuntu-studio-devel] Ubuntu Studio For Musicians > Message-ID: > <CAK_4AvvPUPtQ3iowcGD9iXd1smV1JuYHEFYhcVS02qpNC0i-=w@mail.gmail. > com> > Content-Type: text/plain; charset="utf-8" > > For the record, I almost did not include anything about installing Ubuntu > in the handbook for the reasons Erich gives. My first solution would be to > remove the whole section and just point elsewhere for installation. > I have not run into those problems installing because I've not tried it > on more recent machines. Maybe just a couple of sentences stressing that > "YMMV" and specifically pointing out the UEFI issue on later hardware would > work, but the existing online documentation and forum pages are quite good > for getting Ubuntu Studio up and running. If left in place, the quick > overview could use a link to the better online instructions. I guess I felt > if it were a standalone book, there was no way around at least including > some inkling of how to get started rather than opening with the assumption > that it's already installed. > Thanks for reading it and for the suggestion. It occurs to me that once > this is in the wiki, it would be apparent where to add/edit any particular > aspect. I tried exporting XHTML from LibreOffice Writer and that didn't > work out too well. There are a lot of embedded images. I may need to > copy-paste all 60 pages into a HTML editor to get it formatted so people > can have at it. That could take a while - in the mean time, do let me know > if it's just duplicating some other existing document(s), not all that > useful, too shallow, etc. A true manual might be hundreds of pages in > length, but maybe the fact that it's a bit short-and-sweet is a good > thing? Enough to get going without being overwhelmed was the goal. > > Pete > > > > > > > Luke, > > > > I understand your frustrations on this, but I'm afraid it will fall on > > deaf ears in this mailing list since the issues don't seem to be > > specific to Ubuntu Studio. > > > > Peter can correct me if I'm wrong, but I would say technical stuff like > > that is far beyond the scope of this handbook. It might seem like > > something easy to teach but in reality, it's not. I will say, however, > > that there can be an area on the wiki for that, although, since it's not > > Ubuntu Studio specific and applies to Ubuntu as a whole, it should be > > included in the main Ubuntu wiki. > > > > Remember, Ubuntu Studio is, to put it simply, a customized version of > > Ubuntu. Under-the-hood things like UEFI, BIOS, and other items are not > > within the scope of the Ubuntu Studio development team. For those > > things, there's the main ubuntu-devel mailing list. > > > > The scope of the Ubuntu Studio development team consists of the > > ubuntustudio-* packages primarily. We do not develop Ubiquity (the > > Ubuntu installer program). It is developed by the main Ubuntu > > development team. > > > > Also, and I cannot emphasize this enough, none of the Ubuntu Studio > > developers are paid to do this. It is a completely volunteer project. > > > > With that said, Luke, please take these frustrations to the ubuntu-devel > > mailing list so that the main Ubuntu Development team can have a go to > > address these issues. > > > > > > Erich > > > > -------------- next part -------------- > > A non-text attachment was scrubbed... > > Name: signature.asc > > Type: application/pgp-signature > > Size: 488 bytes > > Desc: OpenPGP digital signature > > URL: <https://lists.ubuntu.com/archives/ubuntu-studio-devel/ > > attachments/20180603/7c6efd43/attachment.sig> > > > > ------------------------------ > > > > Subject: Digest Footer > > > > -- > > ubuntu-studio-devel mailing list > > ubuntu-studio-devel@lists.ubuntu.com > > Modify settings or unsubscribe at: https://lists.ubuntu.com/ > > mailman/listinfo/ubuntu-studio-devel > > > > > > ------------------------------ > > > > End of ubuntu-studio-devel Digest, Vol 133, Issue 6 > > *************************************************** > > > -------------- next part -------------- > An HTML attachment was scrubbed... > URL: <https://lists.ubuntu.com/archives/ubuntu-studio-devel/ > attachments/20180603/7caa97ec/attachment-0001.html> > > ------------------------------ > > Message: 3 > Date: Sun, 3 Jun 2018 17:43:45 -0700 > From: Erich Eickmeyer <er...@ericheickmeyer.com> > To: ubuntu-studio-devel@lists.ubuntu.com > Subject: Re: [ubuntu-studio-devel] Saturday's Meeting (June 2, 2018) > Message-ID: <b85cc5fd-fb2e-62d9-1c33-7041cc6f3...@ericheickmeyer.com> > Content-Type: text/plain; charset="utf-8" > > Hey Ross! I know you just saw the emails, but I'll get you up-to-speed > with a TL;DR version. > > I'm so glad you're back! Right now, Len is working on -controls and > -plasma (when -controls is ready), I'm working on -welcome and > -software-boutique. Eylul and Ryan (SlidingHorn) were working on > (finally) getting the new website theme loaded, but hit a number of > roadblocks, namely upload permissions to the website's server. Ryan, > Charlie (hangar18), and now Pete are our Documentation team. Ryan, has > already been part of the wiki team, so he's been stepping-in to lead > that charge. > > I have the feeling that we're going to get a lot of wallpaper > submissions this time around, so a contest has been proposed with people > voting on which ones they like. I saw that this had been done in the > past, so I think it would be imperative with all the creativity flowing. > Eylul made one (I think?), I got a handful from Karl Schneider, and > Charlie has mentioned he'd like to submit some. That said, it would be a > great way to get the community involved and showcase what people are > doing with Ubuntu Studio. > > Anyhow, I know you just read your eyeballs out at my ramblings. Let me > know if you need anything. :) > > > Erich > > > On 6/2/2018 6:14 AM, Ross Gammon wrote: > > I don't believe it - I was likely to attend this week ;-) > > > > Sorry - I have been working overseas for the last 3 weeks, and only just > > caught up with a months emails. But I should be staying home for the > > coming month or so. > > > > Are there any packages nearly ready for an upload that I could take a > > look at and try to move forward? > > > > Ross > > > > On 06/01/2018 04:50 PM, Charlie wrote: > >> good morning from California! I'm ok with cancelling the meeting. > >> > >> For me: I've yet to settle into a project to work on for Ubunu Studio. > I'm still very interested in starting with documentation (since I feel like > that's the 'entry' level project that I should do since I don't have any > programming skills yet). > >> > >> is there any need for wallpapers? i can work on some photos for that. > >> > >> that's the end of my report. > >> > >> charlie > >> > >>> On May 31, 2018, at 21:24, Erich Eickmeyer <er...@ericheickmeyer.com> > wrote: > >>> > >>> Hey everyone, > >>> > >>> Something has come up and I'm likely not to be able to be at Saturday's > >>> meeting. With that, I think it was just going to be a progress report > >>> anyhow, so I'm all for canceling the meeting this week. Perhaps we can > >>> just give progress reports on our various projects by replying to this > >>> thread. > >>> > >>> I'll start: I'm still working on rebranding ubuntustudio-welcome to be, > >>> well, Ubuntu Studio as opposed to other flavors. My progress is > >>> slow-going, but if anybody wants to chip-in they can find the git repo > >>> on my Launchpad page, and it should also be listed under the Ubuntu > >>> Studio project itself. > >>> > >>> That's all I've got. I would love to hear whatever else anybody has. > >>> > >>> -Erich > >>> > >>> > >>> -- > >>> ubuntu-studio-devel mailing list > >>> ubuntu-studio-devel@lists.ubuntu.com > >>> Modify settings or unsubscribe at: https://lists.ubuntu.com/ > mailman/listinfo/ubuntu-studio-devel > >> > > > > > -------------- next part -------------- > A non-text attachment was scrubbed... > Name: signature.asc > Type: application/pgp-signature > Size: 488 bytes > Desc: OpenPGP digital signature > URL: <https://lists.ubuntu.com/archives/ubuntu-studio-devel/ > attachments/20180603/e052592f/attachment-0001.sig> > > ------------------------------ > > Message: 4 > Date: Sun, 3 Jun 2018 18:09:06 -0700 > From: Charlie <cont...@charlieluna.com> > To: Ubuntu Studio Development <ubuntu-studio-devel@lists.ubuntu.com> > Subject: Re: [ubuntu-studio-devel] Saturday's Meeting (June 2, 2018) > Message-ID: <c365571d-7e6f-46e0-8853-c04a42aef...@charlieluna.com> > Content-Type: text/plain; charset=us-ascii > > > > Sent from my iPhone > > > On Jun 3, 2018, at 17:43, Erich Eickmeyer <er...@ericheickmeyer.com> > wrote: > > > > Hey Ross! I know you just saw the emails, but I'll get you up-to-speed > > with a TL;DR version. > > > > I'm so glad you're back! Right now, Len is working on -controls and > > -plasma (when -controls is ready), I'm working on -welcome and > > -software-boutique. Eylul and Ryan (SlidingHorn) were working on > > (finally) getting the new website theme loaded, but hit a number of > > roadblocks, namely upload permissions to the website's server. Ryan, > > Charlie (hangar18), and now Pete are our Documentation team. Ryan, has > > already been part of the wiki team, so he's been stepping-in to lead > > that charge. > > > > I have the feeling that we're going to get a lot of wallpaper > > submissions this time around, so a contest has been proposed with people > > voting on which ones they like. I saw that this had been done in the > > past, so I think it would be imperative with all the creativity flowing. > > Eylul made one (I think?), I got a handful from Karl Schneider, and > > Charlie has mentioned he'd like to submit some. That said, it would be a > > great way to get the community involved and showcase what people are > > doing with Ubuntu Studio. > > > > Anyhow, I know you just read your eyeballs out at my ramblings. Let me > > know if you need anything. :) > > > > > > Erich > > > > > >> On 6/2/2018 6:14 AM, Ross Gammon wrote: > >> I don't believe it - I was likely to attend this week ;-) > >> > >> Sorry - I have been working overseas for the last 3 weeks, and only just > >> caught up with a months emails. But I should be staying home for the > >> coming month or so. > >> > >> Are there any packages nearly ready for an upload that I could take a > >> look at and try to move forward? > >> > >> Ross > >> > >>> On 06/01/2018 04:50 PM, Charlie wrote: > >>> good morning from California! I'm ok with cancelling the meeting. > >>> > >>> For me: I've yet to settle into a project to work on for Ubunu Studio. > I'm still very interested in starting with documentation (since I feel like > that's the 'entry' level project that I should do since I don't have any > programming skills yet). > >>> > >>> is there any need for wallpapers? i can work on some photos for that. > >>> > >>> that's the end of my report. > >>> > >>> charlie > >>> > >>>> On May 31, 2018, at 21:24, Erich Eickmeyer <er...@ericheickmeyer.com> > wrote: > >>>> > >>>> Hey everyone, > >>>> > >>>> Something has come up and I'm likely not to be able to be at > Saturday's > >>>> meeting. With that, I think it was just going to be a progress report > >>>> anyhow, so I'm all for canceling the meeting this week. Perhaps we can > >>>> just give progress reports on our various projects by replying to this > >>>> thread. > >>>> > >>>> I'll start: I'm still working on rebranding ubuntustudio-welcome to > be, > >>>> well, Ubuntu Studio as opposed to other flavors. My progress is > >>>> slow-going, but if anybody wants to chip-in they can find the git repo > >>>> on my Launchpad page, and it should also be listed under the Ubuntu > >>>> Studio project itself. > >>>> > >>>> That's all I've got. I would love to hear whatever else anybody has. > >>>> > >>>> -Erich > >>>> > >>>> > >>>> -- > >>>> ubuntu-studio-devel mailing list > >>>> ubuntu-studio-devel@lists.ubuntu.com > >>>> Modify settings or unsubscribe at: https://lists.ubuntu.com/ > mailman/listinfo/ubuntu-studio-devel > >>> > >> > > > > > > -- > > ubuntu-studio-devel mailing list > > ubuntu-studio-devel@lists.ubuntu.com > > Modify settings or unsubscribe at: https://lists.ubuntu.com/ > mailman/listinfo/ubuntu-studio-devel > > > > > ------------------------------ > > Subject: Digest Footer > > -- > ubuntu-studio-devel mailing list > ubuntu-studio-devel@lists.ubuntu.com > Modify settings or unsubscribe at: https://lists.ubuntu.com/ > mailman/listinfo/ubuntu-studio-devel > > > ------------------------------ > > End of ubuntu-studio-devel Digest, Vol 133, Issue 7 > *************************************************** >
-- ubuntu-studio-devel mailing list ubuntu-studio-devel@lists.ubuntu.com Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/ubuntu-studio-devel
