[Plone-docs] Stock styles for documentation (was: Proposal to manage documentation similar to (or along with) core software.)

[Israel Saeta Pérez]

Hello!

IIRC Anne Botwell suggested time ago to create Kupu styles to
differentiate stuff targeted to specific versions of Plone in a clear,
consistent way along our documentation. Also, we can work to tag docs
with the correct version(s) they apply to, and try to improve the way
this info is presented to the user, so it's always clear to him/her.

Yes, please, this is a nice discrete project that someone with design
skills could take on - any volunteers?
I understood that it is something about design and Kupu styles but I need
more info to help.
Who can give some directions to start this task?

I created a ticket about this time ago:
https://dev.plone.org/plone/ticket/9107

Two directions:

- Add the paragraph styles to the kupu styles dropdown. You will need
manager privileges or somebody with manager privileges (I can help ;).
- Style up them placing some CSS in plone.org and ask some admin to push
your changes to the live site.
http://svn.plone.org/svn/plone/Products.PloneOrg/trunk/

Apart from the "warning" and "note" styles, we could have some type of box
with the text "version specific" inside for these... But I don't know if
this is easy to do with CSS ("after" and/or "before" inserting?).

-- israel

[Anne Bowtell]

Perhaps we should take a couple of pages from the documentation and flag
up the sort of styles we think we need. I'll have a go with a page or
two from the theme reference now.

Anne

Hello!

IIRC Anne Botwell suggested time ago to create Kupu styles to
differentiate stuff targeted to specific versions of Plone in a

clear,

consistent way along our documentation. Also, we can work to tag

docs

with the correct version(s) they apply to, and try to improve

the way

this info is presented to the user, so it's always clear to him/her.

Yes, please, this is a nice discrete project that someone with design
skills could take on - any volunteers?

I understood that it is something about design and Kupu styles but I
need more info to help.
Who can give some directions to start this task?
https://dev.plone.org/plone/ticket/9107
* Add the paragraph styles to the kupu styles dropdown. You will
need manager privileges or somebody with manager privileges (I can
help ;).
* Style up them placing some CSS in plone.org <http://plone.org> and
ask some admin to push your changes to the live site.
http://svn.plone.org/svn/plone/Products.PloneOrg/trunk/
Apart from the "warning" and "note" styles, we could have some type of
box with the text "version specific" inside for these... But I don't
know if this is easy to do with CSS ("after" and/or "before" inserting?).
-- israel

--
Anne
___________________________________

Anne Bowtell
Divisional Webmaster
Medical Sciences Division
University of Oxford

***@medsci.ox.ac.uk
-----------------------------------
Medical Sciences Office
John Radcliffe Hospital
Oxford OX3 9DU
01865 228925
-----------------------------------

[Anne Bowtell]

Some specific suggestions for marking up versions here

https://dev.plone.org/plone/ticket/9107#comment:5

Anne

Hello!

IIRC Anne Botwell suggested time ago to create Kupu styles to
differentiate stuff targeted to specific versions of Plone in a

clear,

consistent way along our documentation. Also, we can work to tag

docs

with the correct version(s) they apply to, and try to improve

the way

this info is presented to the user, so it's always clear to him/her.

Yes, please, this is a nice discrete project that someone with design
skills could take on - any volunteers?

I understood that it is something about design and Kupu styles but I
need more info to help.
Who can give some directions to start this task?
https://dev.plone.org/plone/ticket/9107
* Add the paragraph styles to the kupu styles dropdown. You will
need manager privileges or somebody with manager privileges (I can
help ;).
* Style up them placing some CSS in plone.org <http://plone.org> and
ask some admin to push your changes to the live site.
http://svn.plone.org/svn/plone/Products.PloneOrg/trunk/
Apart from the "warning" and "note" styles, we could have some type of
box with the text "version specific" inside for these... But I don't
know if this is easy to do with CSS ("after" and/or "before" inserting?).
-- israel

--
Anne
___________________________________

Anne Bowtell
Divisional Webmaster
Medical Sciences Division
University of Oxford

***@medsci.ox.ac.uk
-----------------------------------
Medical Sciences Office
John Radcliffe Hospital
Oxford OX3 9DU
01865 228925
-----------------------------------