Re: [libreoffice-documentation] Wiki page "Other Resources"

[Drew Jensen]

Howdy,

The last entry on the Documentation talk page is regarding the fr wiki page
use of three categories,
End users, Developers and Documentation Team.

I would agree that this is preferable. I would tweak it a bit by have the
Developers section have two subsections; Application and Scripts/Extensions.

If people agree with that I would do the work on the English page.

Best wishes,

Drew

On Wed, Nov 28, 2018 at 12:54 PM Kenneth Hanson 
wrote:

> The idea was as follows. "Other resources" would be links to miscellaneous
> wiki pages, while "Third Party Resources" is for links to external sites.
> If the names are not obvious enough, I would support changing them.
>
> I was still pondering how to organize things when I got side-tracked by
> other things, but you can see what I was thinking at the time on the
> Documentation
> talk page  and my
> user
> page .
>
> On Wed, Nov 28, 2018 at 1:43 AM K-J LibreOffice 
> wrote:
>
> > Hi all,
> > in the wiki when I'm clicking on menu "Documentation - Other Resources"
> > I'm getting this page:
> > https://wiki.documentfoundation.org/Documentation/Other_Resources
> >
> > This page is started by Kenneth but never been worked on (Perhaps he can
> > tell something about the page). It replaced an other page:
> > https://wiki.documentfoundation.org/Documentation/Third_Party_Resources
> >
> > What will happen with the first page?
> > Should we change the link in menu as long as there happens nothing at
> > the page?
> > What should be the content (if it isn't in the second page)?
> >
> > Perhaps you can discuss it at your meeting today.
> >
> > I'm cc'ing Dennis.
> >
> > --
> > Grüße
> > k-j
> >
> > Member of TheDocumentFoundation
> > https://www.documentfoundation.org/governance/members/
> > https://de.libreoffice.org
> > https://wiki.documentfoundation.org/
> >
> > --
> > To unsubscribe e-mail to:
> documentation+unsubscr...@global.libreoffice.org
> > Problems?
> > https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
> > Posting guidelines + more:
> https://wiki.documentfoundation.org/Netiquette
> > List archive: https://listarchives.libreoffice.org/global/documentation/
> > Privacy Policy: https://www.documentfoundation.org/privacy
> >
>
>
> --
> --Kenneth
>
> --
> To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
> Problems?
> https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
> Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
> List archive: https://listarchives.libreoffice.org/global/documentation/
> Privacy Policy: https://www.documentfoundation.org/privacy
>

-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy

Re: [libreoffice-documentation] Doc team meeting minutes 2018 -11-28

[Drew Jensen]

From another thread on ML currently
(Wiki page "Other Resources")

// lots of good stuff at
https://wiki.documentfoundation.org/Documentation
https://wiki.documentfoundation.org/Documentation/Third_Party_Resources

// and interesting stuff here
"I was still pondering how to organize things when I got side-tracked by
other things, but you can see what I was thinking at the time on the
Documentation
talk page  and my
user
page ."

There is a bunch of reference material.

It might be as easy as the 'more' button on the
documentaiton.libreoffice.org page reference either the documentation page
on the wiki or the Third Party Resources page?

Drew



On Wed, Nov 28, 2018 at 3:28 PM Dave Barton  wrote:

>
> On 28.11.2018 19:49, Olivier Hallot wrote:
> > Wednesday November 28th2018, at 19:30 Berlin Time
> >
> > Presents:Dave Barton, Drew Jensen, Olivier, Cathy Crumbley, Sophia
> > Schröder + unknown (connected to minutes only)
>
> During the meeting there was some discussion about FAQs & HowTos
> (Tutorials) and how to build a collection of the same. For years these
> have been available, although somewhat neglected, on the documentation
> wiki at: https://wiki.documentfoundation.org/Documentation
>
> Some time ago I requested infra to add these to the Documentation
> website pages, with the result that they were added to the side panel
> of: https://documentation.libreoffice.org/en/english-documentation/ A
> subsequent update of that page appears to have removed those links.
> Consequently those links are not readily visible to people visiting the
> Documentation website pages.
>
> Rather than overload the guides with FAQ' & Tutorials, maybe we should
> work on updating these wiki pages and add appropriate links in the guides.
>
> Just a thought.
>
> Dave
>
>
> --
> To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
> Problems?
> https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
> Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
> List archive: https://listarchives.libreoffice.org/global/documentation/
> Privacy Policy: https://www.documentfoundation.org/privacy
>

-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy

Re: [libreoffice-documentation] Doc team meeting minutes 2018 -11-28

[Dave Barton]

On 28.11.2018 19:49, Olivier Hallot wrote:
> Wednesday November 28th2018, at 19:30 Berlin Time
>
> Presents:Dave Barton, Drew Jensen, Olivier, Cathy Crumbley, Sophia
> Schröder + unknown (connected to minutes only)

During the meeting there was some discussion about FAQs & HowTos
(Tutorials) and how to build a collection of the same. For years these
have been available, although somewhat neglected, on the documentation
wiki at: https://wiki.documentfoundation.org/Documentation

Some time ago I requested infra to add these to the Documentation
website pages, with the result that they were added to the side panel
of: https://documentation.libreoffice.org/en/english-documentation/ A
subsequent update of that page appears to have removed those links.
Consequently those links are not readily visible to people visiting the
Documentation website pages.

Rather than overload the guides with FAQ' & Tutorials, maybe we should
work on updating these wiki pages and add appropriate links in the guides.

Just a thought.

Dave


-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy

[libreoffice-documentation] Doc team meeting minutes 2018 -11-28

[Olivier Hallot]

Wednesday November 28th2018, at 19:30 Berlin Time

Presents:Dave Barton, Drew Jensen, Olivier, Cathy Crumbley, Sophia
Schröder + unknown (connected to minutes only)

Fall back chat:
https://irc.documentfoundation.org/?settings=#libreoffice-doc

TDF Jitsi room
https://jitsi.documentfoundation.org/tdfdocteam

Completed Action Items:

    + Proposal for the future LibreOffice documentation development
workflow (Dave)
    Dave: My proposal for the workflow would be:
    - Run conversion script on the last edition of each chapter to
be worked on.
    - Apply the new template to the converted chapter.
    - Updated the chapter's technical content.
    - Final stage chapter cleanup & review.
    Dave:

  * Complete the old -> new styles conversion list for Drew's script (Dave)

  * Complete the 2nd. draft of the 6.x template (Dave)

  * The first item is somewhat interdependent on the second one, but
both are reasonably close to completion

  * Create the conversion script (Drew)


 + Enter images in document (Cathy)
AI: Clarify the image anchoring (olivier)
 +File with comments on assembling a master document for Guides
 https://nextcloud.documentfoundation.org/s/g3o4wLRJcPcB34P
 +Quote on images:
   "Bug
https://bugs.documentfoundation.org/show_bug.cgi?id=86322prevent images
with character anchors to display in 
   Master Document. As results, the frame with caption only displays
the caption with no image. Nevertheless the frame 
   keeps the size of the original image, even if invisible.
 
   To circumvent: For each image inside the chapter, anchor the
image to PARAGRAPH inside the frame.
   Select the image in the frame, click mouse button 2, select
Anchor, choose To Paragraph.
   An extra paragraph may (or not) pop at the top of the caption
inside the frame. Just delete it."

Pending:

AI: Emails developers to get more clarifications (Drew)
 + Appendix on CPU issues for Calc (threading, OpenCL)

    + What happen with the wiki page "Other Resources"? See the discussion:
https://listarchives.libreoffice.org/global/documentation/msg12533.html

Agenda+ Discussion: 
    * Help pages
    + [I]: Added some extension to the XML to make Help edition
easier (olivier)

    * Python Help pages
    + Added entry pages for Python scripts documentation (olivier)
    + Need skilled volunteers to fill contents

    * Guides:
    + Create the conversion script (Drew)

  * AI: Update Contributors Guides with changes from Dave? (Drew)

  * Yes.


 * Long editing session turns LO slow and unusable (Cathy)
 + Some crashes. 
 + Confirmed by 3rd party on the large amount of changes (blog
post - Cathy)
 + get feedback sooner to accept/reject changes, shrink the file
(drew)
 + May use online version to get it faster/easier for review
(drew, olivier)

 * Contents of the Guides (Cathy)
 + Shall we review the contents of each chapter
    + some contents too basic
 + Let's survey a broader audience on what must go to inside the
Guides (all)
    + Use TDF survey (olivier)
AI  + define the right set of questions for the contents (olivier)
    https://nextcloud.documentfoundation.org/s/8JKKSzxji2WwXH4

Next meeting WednesdayDecember5th2018, at 19:30 Berlin Time

-- 
Olivier Hallot
LibreOffice Documentation Coordinator
Comunidade LibreOffice 
Rio de Janeiro - Brasil - Local Time: UTC-03:00
http://tdf.io/joinus 


-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy

Re: [libreoffice-documentation] Wiki page "Other Resources"

[Kenneth Hanson]

The idea was as follows. "Other resources" would be links to miscellaneous
wiki pages, while "Third Party Resources" is for links to external sites.
If the names are not obvious enough, I would support changing them.

I was still pondering how to organize things when I got side-tracked by
other things, but you can see what I was thinking at the time on the
Documentation
talk page  and my user
page .

On Wed, Nov 28, 2018 at 1:43 AM K-J LibreOffice  wrote:

> Hi all,
> in the wiki when I'm clicking on menu "Documentation - Other Resources"
> I'm getting this page:
> https://wiki.documentfoundation.org/Documentation/Other_Resources
>
> This page is started by Kenneth but never been worked on (Perhaps he can
> tell something about the page). It replaced an other page:
> https://wiki.documentfoundation.org/Documentation/Third_Party_Resources
>
> What will happen with the first page?
> Should we change the link in menu as long as there happens nothing at
> the page?
> What should be the content (if it isn't in the second page)?
>
> Perhaps you can discuss it at your meeting today.
>
> I'm cc'ing Dennis.
>
> --
> Grüße
> k-j
>
> Member of TheDocumentFoundation
> https://www.documentfoundation.org/governance/members/
> https://de.libreoffice.org
> https://wiki.documentfoundation.org/
>
> --
> To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
> Problems?
> https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
> Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
> List archive: https://listarchives.libreoffice.org/global/documentation/
> Privacy Policy: https://www.documentfoundation.org/privacy
>


-- 
--Kenneth

-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy

[libreoffice-documentation] Re: Proposed XHP extensions

[Olivier Hallot]

Hi all concerned in writing Help pages!

I patched the LibreOffice Help submodule code with the following
extensions to XHP

Class Paragraph-like

 ... 

,  and 

Class Character-like

, , , , 

All these extensions above are documented in the XHP reference page in

https://wiki.documentfoundation.org/Documentation/Understanding,_Authoring_and_Editing_Openoffice.org_Help/3

Patch is

https://gerrit.libreoffice.org/#/c/63954/

IMPORTANT

In any case these extensions break the existing markup and contents.

Please do not change existing contents based on these extensions, it
will force a useless re-translation.

However, it is OK when updating contents,  and use the opportunity to
also apply the extended markup.

Kind regards

Olivier

Em 22/10/2018 07:55, Olivier Hallot escreveu:
> Hello everyone concerned on writing Help pages
>
> After significant amount of time spent writing and fixing Help pages
> (XHP), I came to conclusion that the Help XML (XHP) is a powerful markup
> but a bit too hard to master for newcomers and easy to have errors and
> mistakes slipped in files. Some of its complexity are not absolutely
> required so I wrote a wiki page suggesting the implementation of XHP
> extensions, aiming to make life simpler for adding and reading XHP
> contents textually (markup).
>
> Please note that in any case the current markup is affected, so it will
> preserve the legacy contents as well as the current translations.
>
> For example, the new markup for 'tip' paragraph should be
>
> 
>
> so it can replace
> 
>
> Yes, it is a trivial change but I hope it will make reading easier for all.
>
> Handling of the XHP extensions will be in the XSLT transformation and it
> will be patched accordingly, as well as the DTD, wiki documentation on
> XHP, and string extractors for Pootle.
>
> The wiki page is
>
> https://wiki.documentfoundation.org/Documentation/Proposed_Extensions_for_XHP
>
> And comments are welcome, do's dont's, thumbs up or thumbs down.
>
> regards

-- 
Olivier Hallot
LibreOffice Documentation Coordinator
Comunidade LibreOffice 
Rio de Janeiro - Brasil - Local Time: UTC-03:00
http://tdf.io/joinus 


-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy

[libreoffice-documentation] REMIND: Documentation team call is today at 19:30 Berlin Time

[Olivier Hallot]

Hi Documentation Team (Guides, Help contents) !

Our documentation team meeting will take place today at 19:30 CET
(Berlin time).

We will use the following jitsi  meeting room

https://jitsi.documentfoundation.org/tdfdocteam

The meeting room is supposed to work will all browsers without the need
of a specific plugin.

The documentation pad for the meeting minute is
http://pad.documentfoundation.org/p/documentation

Main topics
* Please fill the pad with the topics you want to be discussed.

See you later!
-- 
Olivier Hallot
LibreOffice Documentation Coordinator
Comunidade LibreOffice
Rio de Janeiro - Brasil - Local Time: UTC-03:00
http://tdf.io/joinus

-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy