[FM Discuss] Bug with chapter titles

Michael McAndrew michaelmcandrew at thirdsectordesign.org
Fri Dec 17 05:13:24 PST 2010


I know what you are saying.  Booki is the editing platform, where we edit
books.  It's not the reading platform where we read them.

I guess the confusion crept in because http://en.flossmanuals.net/civicrm is
still being fed from the old editing platform (and hence still has the old
URLs in).

Following form that (sorry if you have answered these questions already :)
...

* Can we publish to http://en.flossmanuals.net/civicrm from booki at the
moment?

* Agree that it is confusing to have two read only versions.

Am I right in saying that 2 is a read only version of 'trunk' and 3 is the
latest stable release.  A read only version of trunk is useful when you are
editing to see what your changes will look like before publishing, but
perhaps this could be acheived by just hitting a preview / publish button
and getting a copy located in a preview-like URL, kind of like a release
candidate?  So the workflow would be to go from TOC to edit without a view
stage between?

I could live without 2, but it is kind of useful.  how about styling 2 so it
is obviously 'unpublished'?






On Fri, Dec 17, 2010 at 12:11 PM, adam <adam at xs4all.nl> wrote:

> ok...so i think we might have a issue here with confusion over the 'read
> only' version of the manual in the editing section
> (booki.flossmanuals.net) AND the 'read' version of the manual located
> here:
> http://en.flossmanuals.net
>
> as i am seeing it...we do need to resolve the issue of duplicate url
> name for chapters...however, i am also considering the possibility to
> turn off the 'read only' display in booki.flossmanuals.net
>
> for example...
>
> 1. we have the edit interface for civicrm:
> http://booki.flossmanuals.net/civicrm/edit/
>
> 2. and then the 'read only' version:
> http://booki.flossmanuals.net/civicrm/
>
> 3. and then the manual for users:
> http://en.flossmanuals.net/civicrm
>
>
> My feeling is that we have a big potential problem with people confusing
> 2+3 ie. thinking that option 2 *is* option 3
>
> My feeling that this is happening is enhanced when I see some bugs being
> tracked which see to also share this confusion:
> http://booki-dev.flossmanuals.net/ticket/326
>
> So...while we need to fix the duplicate url issue, i think we can also
> shut down option 2 since the edit interface now also has a 'view' button
> so you can read chapters without needing to edit them
>
> i know this is a lot to digest but if anyone can follow this and comment
> on it i would appreciate any thoughts on this
>
> adam
>
>
> On Fri, 2010-12-17 at 00:29 +0000, Michael McAndrew wrote:
> >         sooo... you want to switch between full chapter name and
> >         shorther url
> >         name in editor (in TOC)? is that what you want? that is so
> >         crazy that
> >         it might just work! :)
> >
> > I love it when a plan comes together.  yeah, the more i think about
> > it, the more i like the section/chapter hierarchy for the civicrm
> > book.
> >
> > so we would have
> >
> > fundraising/about
> > fundraising/planning
> > fundraising/configuring
> > membership/about
> > membership/planning
> > membership/configuring
> >
> > etc.
> >
> > that looks pretty to me (i know, i'm sick).
> >
> > imagine this would look really ugly in other situations though, so if
> > we could have the flexibilidad that would be awesome :)
> >
> >
> > On Thu, Dec 16, 2010 at 11:33 PM, Aleksandar Erkalovic
> > <aerkalov at gmail.com> wrote:
> >         On Thu, Dec 16, 2010 at 8:34 PM, Michael McAndrew
> >         <michaelmcandrew at thirdsectordesign.org> wrote:
> >         > one problem - is this reported yet? we get a predictable
> >         error in civicrm
> >         > because we repeat a lot of chapter titles on purpose to
> >         guide people through
> >         > the book. for example.
> >         > http://booki.flossmanuals.net/civicrm/_v/1.0/planning/
> >
> >
> >         yes... aware of this. did not implement anything before
> >         because i knew
> >         people will get broken links in books. was thinking of maybe
> >         implementing intelligent rename tool... also, it kind of
> >         waited for
> >         permissions. we do have permissions now (at least in code), so
> >         i guess
> >         i could implement chapter url_name rename also.
> >
> >         > my ideal world enhancement/solution to this would be to have
> >         the option of
> >         > overriding chapters names on an adhoc basis and to be able
> >         to switch between
> >         > a "section/chapter" and just plain old "chapter" url schema
> >         for the default
> >         > chapter titles.
> >         >
> >         > thought it might be worth discussing here a bit?
> >
> >
> >         sooo... you want to switch between full chapter name and
> >         shorther url
> >         name in editor (in TOC)? is that what you want? that is so
> >         crazy that
> >         it might just work! :)
> >
> >
> >         aco
> >
> >         --
> >          http://www.binarni.net/
> >         _______________________________________________
> >         Discuss mailing list
> >         Discuss at lists.flossmanuals.net
> >
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
> >
> >
> >
> >
> > --
> > Michael McAndrew
> > 07817 802299 (mobile)
> >
> > Third Sector Design Ltd.
> > http://thirdsectordesign.org
> >
> > For support, email support at thirdsectordesign.org
> > _______________________________________________
> > Discuss mailing list
> > Discuss at lists.flossmanuals.net
> > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
>
>
> _______________________________________________
> Discuss mailing list
> Discuss at lists.flossmanuals.net
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
>



-- 
Michael McAndrew
07817 802299 (mobile)

Third Sector Design Ltd.
http://thirdsectordesign.org

For support, email support at thirdsectordesign.org
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.flossmanuals.net/pipermail/discuss-flossmanuals.net/attachments/20101217/4e047ffd/attachment.htm>


More information about the Discuss mailing list