Hello, Dokuwiki also have markdown support with plugin so should we have 'original' in github as rst-file (If we like translations also). Then we could have these as base for Dokuwiki then use normal Pull Requests to update those. Little bit double effort but as Be said more qualified documentation but can be automated with script? Because how many edits regular Dokuwiki than Be? Because without good documentation application like Mixxx is unusable and it won't conquer world.
Thanks, Tuukka Text is now very fluent and makes all the necesery recommendations. 13.11.2015, 08:44, Be kirjoitti: > Thanks. I propose adopting this as our procedure for writing > documentation when the author is not very comfortable with English: > > 1. Original author writes documentation to the best of their ability > 2. Original author posts on this mailing list or submits a pull > request asking for someone who knows English well to edit it > 3. Someone who knows English well edits the documentation > 4. Original author checks that the text still has all the correct > information > > I've edited what you put on the Contributing Mappings page. I also > added a little to the required conventions. Please make sure it is > still correct. > > On 11/12/2015 08:13 AM, Tuukka Pasanen wrote: >> Hello, >> Ok I updated Wiki someone with better understanding English should read >> it (and correct it) and everyone else also because we have to maintain >> these conventions. >> >> Tuukka >> >> 12.11.2015, 15:17, Be kirjoitti: >>> >>> >>> On 11/12/2015 12:32 AM, Tuukka Pasanen wrote: >>>> Hello, >>>> Sorry this is lacking time of time but we should update wiki with >>>> these >>>> tools I think: >>>> XML: >>>> libxml 'xmllint -format' >>>> or >>>> http://www.freeformatter.com/xml-formatter.html (with '2 spaces per >>>> indent level') >>>> >>>> Javascript: >>>> at least header: >>>> //////////////////////////////////////////////////////////////////////// >>>> >>>> // JSHint configuration // >>>> //////////////////////////////////////////////////////////////////////// >>>> >>>> /* global engine */ >>>> /* global script */ >>>> /* global print */ >>>> /* global midi */ >>>> //////////////////////////////////////////////////////////////////////// >>>> >>>> >>>> JSHint (http://jshint.com/) for lazy one's there is FixMyJS >>>> (https://github.com/jshint/fixmyjs) but I can't recomend it only with >>>> care! >>>> JS-Beautifier (http://jsbeautifier.org/) >>>> >>>> Those are nodejs-modules: >>>> https://www.npmjs.com/package/js-beautify >>>> https://www.npmjs.com/package/jshint >>>> >>>> Currently I'm evaluating tool: >>>> https://www.npmjs.com/package/jscs >>>> >>>> are mandatory for getting scripts through so we don't have to nack >>>> about >>>> these every time >>> >>> It's a wiki, so you can go ahead and write that on the wiki yourself. >>> >>> IMO it's great that JSHint keeps evil doers away :P >>> https://www.youtube.com/watch?v=-C-JoyNuQJs&t=39m48s >>> >>>> I'm very happy that controllers are flowing in and they are getting >>>> some >>>> love! >>> >>> Me too! >>> >>> I think I'll get an Akai AMX soon and use it to develop the layering >>> library because it's such a simple controller. >>> >>>> Tuukka >>>> >>>> 24.10.2015, 19:21, Be kirjoitti: >>>>> Seems like a good idea to require new scripts to use strict. >>>>> >>>>> On 10/24/2015 10:06 AM, Tuukka Pasanen wrote: >>>>>> Hi, >>>>>> Can we expect them to use 'use strict'? In Perl that makes most of >>>>>> stupid >>>>>> coding conventions disappear. More on topic: >>>>>> http://ejohn.org/blog/ecmascript-5-strict-mode-json-and-more/ >>>>>> >>>>>> Tuukka >>>>>> >>>>>> 23.10.2015, 15:41, Be kirjoitti: >>>>>>> That was already on Controller Mapping File Locations page, but now >>>>>>> that >>>>>>> you mention it, I moved it to the Contributing Mappings page. >>>>>>> >>>>>>> On 10/23/2015 12:29 AM, Tuukka Pasanen wrote: >>>>>>>> Hi, >>>>>>>> I'll try to come up with small template. Should we announce of >>>>>>>> naming >>>>>>>> scheme at wiki as it seems to be: >>>>>>>> 'Manucfacturer-Sellingname-Typenumber-scripts.js' and >>>>>>>> 'Manufacturer >>>>>>>> Sellingname Typenumber-midi.xml'. >>>>>>>> >>>>>>>> Tuukka >>>>>>>> >>>>>>>> 23.10.2015, 08:04, Be kirjoitti: >>>>>>>>> No, there is not. It would be great if you made these >>>>>>>>> templates. We >>>>>>>>> could ship them with Mixxx and tell users on the wiki to look at >>>>>>>>> those >>>>>>>>> templates. >>>>>>>>> >>>>>>>>> On 10/22/2015 11:58 PM, Tuukka Pasanen wrote: >>>>>>>>>> Hello, >>>>>>>>>> Yes we have to express minumun requirements for javascript and >>>>>>>>>> XML. Is >>>>>>>>>> there possibility have template js and XML with proper naming >>>>>>>>>> scheme or >>>>>>>>>> is there anyt similiarities with these files. I have to >>>>>>>>>> investigate >>>>>>>>>> this >>>>>>>>>> template thing. >>>>>>>>>> >>>>>>>>>> Tuukka >>>>>>>>>> >>>>>>>>>> 23.10.2015, 06:56, Be kirjoitti: >>>>>>>>>>> I started a section on the Contributing Mappings wiki page >>>>>>>>>>> (http://mixxx.org/wiki/doku.php/contributing_mappings ) with >>>>>>>>>>> guidelines >>>>>>>>>>> for designing mappings. If you would like to add to or change >>>>>>>>>>> them, >>>>>>>>>>> discuss it here or edit the wiki. >>>>>>>>>>> >>>>>>>>>>> ------------------------------------------------------------------------------ >>>>>>>>>>> >>>>>>>>>>> >>>>>>>>>>> >>>>>>>>>>> >>>>>>>>>>> >>>>>>>>>>> _______________________________________________ >>>>>>>>>>> Get Mixxx, the #1 Free MP3 DJ Mixing software Today >>>>>>>>>>> http://mixxx.org >>>>>>>>>>> >>>>>>>>>>> >>>>>>>>>>> Mixxx-devel mailing list >>>>>>>>>>> Mixxx-devel@lists.sourceforge.net >>>>>>>>>>> https://lists.sourceforge.net/lists/listinfo/mixxx-devel >>>>>>>>>> ------------------------------------------------------------------------------ >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> _______________________________________________ >>>>>>>>>> Get Mixxx, the #1 Free MP3 DJ Mixing software Today >>>>>>>>>> http://mixxx.org >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> Mixxx-devel mailing list >>>>>>>>>> Mixxx-devel@lists.sourceforge.net >>>>>>>>>> https://lists.sourceforge.net/lists/listinfo/mixxx-devel >>>>>>>>>> >>>>>>>>> ------------------------------------------------------------------------------ >>>>>>>>> >>>>>>>>> >>>>>>>>> >>>>>>>>> >>>>>>>>> >>>>>>>>> _______________________________________________ >>>>>>>>> Get Mixxx, the #1 Free MP3 DJ Mixing software Today >>>>>>>>> http://mixxx.org >>>>>>>>> >>>>>>>>> >>>>>>>>> Mixxx-devel mailing list >>>>>>>>> Mixxx-devel@lists.sourceforge.net >>>>>>>>> https://lists.sourceforge.net/lists/listinfo/mixxx-devel >>>>>>>> >>>>>>>> ------------------------------------------------------------------------------ >>>>>>>> >>>>>>>> >>>>>>>> >>>>>>>> >>>>>>>> >>>>>>>> _______________________________________________ >>>>>>>> Get Mixxx, the #1 Free MP3 DJ Mixing software Today >>>>>>>> http://mixxx.org >>>>>>>> >>>>>>>> >>>>>>>> Mixxx-devel mailing list >>>>>>>> Mixxx-devel@lists.sourceforge.net >>>>>>>> https://lists.sourceforge.net/lists/listinfo/mixxx-devel >>>>>>>> >>>>>>> ------------------------------------------------------------------------------ >>>>>>> >>>>>>> >>>>>>> >>>>>>> >>>>>>> >>>>>>> _______________________________________________ >>>>>>> Get Mixxx, the #1 Free MP3 DJ Mixing software Today >>>>>>> http://mixxx.org >>>>>>> >>>>>>> >>>>>>> Mixxx-devel mailing list >>>>>>> Mixxx-devel@lists.sourceforge.net >>>>>>> https://lists.sourceforge.net/lists/listinfo/mixxx-devel >>>>>> >>>> >> ------------------------------------------------------------------------------ _______________________________________________ Get Mixxx, the #1 Free MP3 DJ Mixing software Today http://mixxx.org Mixxx-devel mailing list Mixxx-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/mixxx-devel
