From mboxrd@z Thu Jan 1 00:00:00 1970 From: Matthias Fischer To: documentation@lists.ipfire.org Subject: Re: New Wiki Software - Please help testing :) Date: Mon, 27 May 2019 19:10:28 +0200 Message-ID: In-Reply-To: MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="===============0198783303569734480==" List-Id: --===============0198783303569734480== Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable On 27.05.2019 18:27, Michael Tremer wrote: > Hello, >=20 > ... > * Matthias saved the same page a couple of times. That definitely shows tha= t we need a preview function :) Yep. My opinion: I/we need this. Every now and then it happens that you'll miss something or produce a typo. A preview function would help avoiding this. > I do not want to point any fingers here at all. But I learned things from t= his. If it felt natural for you to do these things, but it was meant in anoth= er way then this is a bug in the software. >=20 > But I have no idea how to find a good solution for this. Admittedly nothing= is documented yet, but future editors might not read the documentation. Peop= le edit first and I do want anyone to edit this wiki. We care about the infor= mation first, but we need to make sure that people do not mess up the markup. That's why I - personally - would like to have something like 'Markdown'. > I think that Dokuwiki is quite bad in that sense that it allows to be messy= with the markup. This is also why conversion into another language is so dif= ficult. There is multiple ways to do something and they can be mixed. Horror. I wrote this with DokuWiki and I think, I know what you mean: http://www.copfilter.org/wiki But I liked the editing tools... ;-) > So what springs to mind here is: We could refuse saving the page when somet= hing is not right. +1 > But I think that might feel very frustrating. An tag should never sho= w up. If we find that, then we can just throw an error. >=20 > What do you guys think could work? We should at least throw an error, refuse to save and go back to editing mode. >=20 > -Michael >=20 > P.S. I pushed out a couple of fixes, but I do not have a preview function y= et. Not sure whether I can make that update live or if we will have a button.= Or maybe a two-step save process. I need to explore that a little. Please se= nd me your thoughts in case you have any ideas. But make them easy to impleme= nt :) I need a documentation... ;-) First thing that puzzled me today, e.g.: On https://wiki.dev.ipfire.org/actions/edit/installation/step1 at page bottom there is a link to the next step: [[./step2]]. This leads to https://wiki.dev.ipfire.org/installation/step1/step2 But this link doesn't work ("Page does not exist") and I have no chance to test it. I can only change something, save the page and and pray that it works. I tried and get: "oops, something went wrong". Hm. Yes. Great. ;-) But what is the right syntax at this point? I'll try on weekend... Best, Matthias --===============0198783303569734480==--