Hi all, In ToriOS we make the manual in LaTeX. This can be exported to various formats. Though I think HTML is the most friendly to all. You can browse it on a phone (if it is coded properly using percentages and whatnot), any computer can look at it (if it is coded properly again...) And it would be very small to have many languages. We could also include nice graphics which always help people be able to see what is going on.
On 11/28/2014 02:52 PM, Walter Lapchynski wrote: > By the way to put this into less technical language, the workflow for > your average user who's not so obsessed with CLI as I am would be > something like: > > 1. Open the Git *GUI* > 2. Get the latest version of the documentation > 3. Edit the appropriate documentation file in your preferred editor > 4. Push the new version of the documentation > > So in a lot of ways this is very much the same as editing the Ubuntu > Wiki for example. The only difference is you're editing it locally, so > there's an extra step. > > Personally, I've never used any Git GUI before but I'd be shocked if > the editor and everything wasn't integrated in. > > tl;dr it shouldn't be much of a difference from the Ubuntu Wiki, but > we'll have maximal control and proper record keeping. > > wxl > > On Fri, Nov 28, 2014 at 12:45 PM, Jonathan Aquilina > <eagles051...@gmail.com> wrote: >> Not a bad idea either. Again Ali do you have any thoughts on these. >> >> On Fri, Nov 28, 2014 at 9:25 PM, Walter Lapchynski <w...@ubuntu.com> wrote: >>> I think blogs are terrible for documentation. We could do a >>> Jekyll-generated "book," kind of like the Font Forge tutorial¹. That >>> way the whole thing is under version control and those of us that >>> don't want to use web tools can be happy with their command line. ☺ >>> >>> wxl >>> >>> http://designwithfontforge.com/en-US/index.html >>> >>> On Fri, Nov 28, 2014 at 12:21 PM, Jonathan Aquilina >>> <eagles051...@gmail.com> wrote: >>>> I normally try and avoid wiki's all together. We could just provide a >>>> website with pages like a blog kind of on wordpress and that way we have >>>> more fine grained control over the content and how to's >>>> >>>> >>>> On Fri, Nov 28, 2014 at 9:19 PM, Walter Lapchynski <w...@ubuntu.com> >>>> wrote: >>>>> Well, I'm adaptable, but learning new markup is always a total pain in >>>>> the butt. I have tried very hard to stick to one and for that I've >>>>> chosen Markdown due to how often it's used. reST is also something I >>>>> wouldn't hate using. I guess given how much I use it, I can handle >>>>> MoinMoin and frankly Trac (we use it at work) is somewhat MoinMoin-ish >>>>> but I find myself often frustrated just doing simple things with it. >>>>> So that's my 2¢. What do you guys think? >>>>> >>>>> wxl >>>>> >>>>> On Fri, Nov 28, 2014 at 12:06 PM, Jonathan Aquilina >>>>> <eagles051...@gmail.com> wrote: >>>>>> Hey WXL :D nice to see you on board. I actually have experience with >>>>>> media >>>>>> wiki which is the platform developed by the wikimedia foundation and >>>>>> used by >>>>>> wikipedia. I am even subscribed to their mailing list. >>>>>> >>>>>> On Fri, Nov 28, 2014 at 8:34 PM, Walter Lapchynski <w...@ubuntu.com> >>>>>> wrote: >>>>>>> I've worked with Launchpad and Trac mostly. I like them both. >>>>>>> Redmine >>>>>>> *IS* really nice from the point of view of a development project >>>>>>> manager. It's flexible, as is Trac. Launchpad is, too, actually. For >>>>>>> example, it can handle git imports [1]. It doesn't have its own wiki >>>>>>> system, which is a bummer, but on the other hand, it means we're not >>>>>>> locked into any particular nuances of someone's wiki system. For >>>>>>> example, I think it's disappointing that Redmine has no support for >>>>>>> Markdown. Plus, the boss is comfortable with Launchpad. Why >>>>>>> re-invent >>>>>>> the wheel? >>>>>>> >>>>>>> This brings the final problem: which wiki system where? I like >>>>>>> GitHub's system. Have they open sourced that already? If it's usable >>>>>>> for a general Git repo, I think that would be wonderful. >>>>>>> >>>>>>> wxl >>>>>>> >>>>>>> [1] http://blog.launchpad.net/bazaar/git-imports >>>>>>> >>>>>>> On Fri, Nov 28, 2014 at 11:14 AM, Gustavo Silva >>>>>>> <gustavosantaremsi...@gmail.com> wrote: >>>>>>>> Well, with my experience (not much, I know) I guess there has to >>>>>>>> be a >>>>>>>> lot of >>>>>>>> diligence in terms of responsibilities. Specially when we're >>>>>>>> working >>>>>>>> together with people around the world. Some decisions will require >>>>>>>> Ali's >>>>>>>> thought, others will have to be taken care of by others. Anyway, >>>>>>>> perhaps >>>>>>>> for >>>>>>>> now I agree with Jonathan on this one. Ali can decide which tool >>>>>>>> to >>>>>>>> use >>>>>>>> and >>>>>>>> then later we can upgrade to other if needed. >>>>>>>> >>>>>>>> >>>>>>>> >>>>>>>> 2014-11-28 14:31 GMT+00:00 Jonathan Aquilina >>>>>>>> <eagles051...@gmail.com>: >>>>>>>>> The reason I really like redmine for example is that we can >>>>>>>>> easily >>>>>>>>> have >>>>>>>>> it >>>>>>>>> integrate with our own git repos which we can host on the kibo >>>>>>>>> server. >>>>>>>>> >>>>>>>>> In the end Ali you have to make the final decisions. >>>>>>>>> >>>>>>>>> On Fri, Nov 28, 2014 at 3:12 PM, Israel <isr...@torios.org> >>>>>>>>> wrote: >>>>>>>>>> Hi, >>>>>>>>>> I am GMT +6 and it was Thanksgiving here :) >>>>>>>>>> >>>>>>>>>> +1 to KISS as always Ali. >>>>>>>>>> I like lp for anything Ubuntu related (like a PPA for >>>>>>>>>> anysoftware >>>>>>>>>> we >>>>>>>>>> create), though if we work with a scripting language (like Bash) >>>>>>>>>> it >>>>>>>>>> can be >>>>>>>>>> anywhere (like GitHub). >>>>>>>>>> >>>>>>>>>> So... all in all we may have to use multiple ones at some point, >>>>>>>>>> but >>>>>>>>>> we >>>>>>>>>> should use whatever the person/people setting it up are most >>>>>>>>>> familiar >>>>>>>>>> with. >>>>>>>>>> >>>>>>>>>> :) >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> On 11/28/2014 06:00 AM, Jonathan Aquilina wrote: >>>>>>>>>> >>>>>>>>>> My exact concerns as well Gustavo. >>>>>>>>>> >>>>>>>>>> On Fri, Nov 28, 2014 at 12:58 PM, Gustavo Silva >>>>>>>>>> <gustavosantaremsi...@gmail.com> wrote: >>>>>>>>>>> I prefer Slack and other lookalike alternatives. But, since you >>>>>>>>>>> guys >>>>>>>>>>> are >>>>>>>>>>> all more used to it, if you prefer, we can keep using >>>>>>>>>>> Launchpad. >>>>>>>>>>> The >>>>>>>>>>> only >>>>>>>>>>> thing I am concerned about is integration with or her tools >>>>>>>>>>> like >>>>>>>>>>> Google >>>>>>>>>>> Drive and Dropbox. But, KISS it - +1 >>>>>>>>>>> >>>>>>>>>>> Best regards/Com os melhores cumprimentos, >>>>>>>>>>> Gustavo Silva >>>>>>>>>>> >>>>>>>>>>> Sent from my Nexus 5 >>>>>>>>>>> >>>>>>>>>>> Em 28/11/2014 11:56, "Ali Linx (amjjawad)" <amjja...@gmail.com> >>>>>>>>>>> escreveu: >>>>>>>>>>>> Hi, >>>>>>>>>>>> >>>>>>>>>>>> Before I log off, I thought I must share this. >>>>>>>>>>>> >>>>>>>>>>>> Launchpad is a great site IMHO to do both team management and >>>>>>>>>>>> project >>>>>>>>>>>> planning at the same time. It has mailing list (this one) and >>>>>>>>>>>> the >>>>>>>>>>>> great and >>>>>>>>>>>> the best part, the blueprints that I adore and love. >>>>>>>>>>>> >>>>>>>>>>>> Not being a dictator, it is UP to YOU all to decide otherwise. >>>>>>>>>>>> >>>>>>>>>>>> NOTE: >>>>>>>>>>>> (1) We do not need to re-invent the wheel. >>>>>>>>>>>> (2) Time is our brutal enemy. >>>>>>>>>>>> (3) KISS (Keep It Simple and Short) is the password. >>>>>>>>>>>> >>>>>>>>>>>> --------- >>>>>>>>>>>> +1 = agree >>>>>>>>>>>> -1 = disagree >>>>>>>>>>>> Comment if you have another/better opinion >>>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>>> -- >>>>>>>>>>>> Remember: "All of us are smarter than any one of us." >>>>>>>>>>>> Best Regards, >>>>>>>>>>>> Ali/amjjawad >>>>>>>>>>>> http://torios.org - StartUbuntu - Ubuntu GNOME - >>>>>>>>>>>> http://amjjawad.net >>>>>>>>>>>> >>>>>>>>>>>> -- >>>>>>>>>>>> Mailing list: https://launchpad.net/~kibo-project >>>>>>>>>>>> Post to : kibo-project@lists.launchpad.net >>>>>>>>>>>> Unsubscribe : https://launchpad.net/~kibo-project >>>>>>>>>>>> More help : https://help.launchpad.net/ListHelp >>>>>>>>>>>> >>>>>>>>>>> -- >>>>>>>>>>> Mailing list: https://launchpad.net/~kibo-project >>>>>>>>>>> Post to : kibo-project@lists.launchpad.net >>>>>>>>>>> Unsubscribe : https://launchpad.net/~kibo-project >>>>>>>>>>> More help : https://help.launchpad.net/ListHelp >>>>>>>>>>> >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> -- >>>>>>>>>> Jonathan Aquilina >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> -- >>>>>>>>>> Regards >>>>>>>>>> >>>>>>>>>> -Israel >>>>>>>>>> ToriOS Team >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> -- >>>>>>>>>> Mailing list: https://launchpad.net/~kibo-project >>>>>>>>>> Post to : kibo-project@lists.launchpad.net >>>>>>>>>> Unsubscribe : https://launchpad.net/~kibo-project >>>>>>>>>> More help : https://help.launchpad.net/ListHelp >>>>>>>>>> >>>>>>>>> >>>>>>>>> >>>>>>>>> -- >>>>>>>>> Jonathan Aquilina >>>>>>>>> >>>>>>>>> -- >>>>>>>>> Mailing list: https://launchpad.net/~kibo-project >>>>>>>>> Post to : kibo-project@lists.launchpad.net >>>>>>>>> Unsubscribe : https://launchpad.net/~kibo-project >>>>>>>>> More help : https://help.launchpad.net/ListHelp >>>>>>>>> >>>>>>>> >>>>>>>> >>>>>>>> -- >>>>>>>> Best Regards / Obrigado e com os melhores cumprimentos, >>>>>>>> Gustavo >>>>>>>> >>>>>>>> >>>>>>>> -- >>>>>>>> Mailing list: https://launchpad.net/~kibo-project >>>>>>>> Post to : kibo-project@lists.launchpad.net >>>>>>>> Unsubscribe : https://launchpad.net/~kibo-project >>>>>>>> More help : https://help.launchpad.net/ListHelp >>>>>>>> >>>>>>> >>>>>>> >>>>>>> -- >>>>>>> @wxl >>>>>>> Lubuntu Release Manager, Head of QA >>>>>>> Ubuntu PPC Point of Contact >>>>>>> Ubuntu Oregon LoCo Team Leader >>>>>> >>>>>> >>>>>> >>>>>> -- >>>>>> Jonathan Aquilina >>>>> >>>>> >>>>> -- >>>>> @wxl >>>>> Lubuntu Release Manager, Head of QA >>>>> Ubuntu PPC Point of Contact >>>>> Ubuntu Oregon LoCo Team Leader >>>> >>>> >>>> >>>> -- >>>> Jonathan Aquilina >>> >>> >>> -- >>> @wxl >>> Lubuntu Release Manager, Head of QA >>> Ubuntu PPC Point of Contact >>> Ubuntu Oregon LoCo Team Leader >> >> >> >> -- >> Jonathan Aquilina > > -- Regards -Israel ToriOS Team -- Mailing list: https://launchpad.net/~kibo-project Post to : kibo-project@lists.launchpad.net Unsubscribe : https://launchpad.net/~kibo-project More help : https://help.launchpad.net/ListHelp
