OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Fwd: Plaintive plea for actual style specifications for OASIS publications


FYI

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)



-------- Forwarded Message --------
Subject: Plaintive plea for actual style specifications for OASIS publications
Date: Sat, 9 Feb 2019 08:55:11 -0500
From: Kristen James Eberlein <kris@eberleinconsulting.com>
To: Chet Ensign <Chet.Ensign@oasis-open.org>, Paul Knight <paul.knight@oasis-open.org>, G Ken Holman <gkholman@cranesoftwrights.com>, Dave Lemire <dave.lemire@g2-inc.com>


Guys, I want to suggest that OASIS establish style specifications for specifications and committee notes. TC administration and TCs then can work from those style specifications to build the following:

  • Stylesheets for rendering from DITA
  • Stylesheets for rendering from Docbook
  • Word templates for OASIS TCs that use Word
  • Open Office templates for OASIS TC that use Open Office

This would be much more efficient, not to mention being a more appropriate process for OASIS! And I'd be glad to help OASIS with methodology for documenting document-rendering specifications, as I am sure others would also.

It's very painful and time-consuming to reverse-engineer style specifications from a Word template. And it often seems as if we are working with moving targets ...

Can we change this process? Please?

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)



-------- Forwarded Message --------
Subject: Fwd: Re: [dita] Re: Changes in the new design for OASIS Committee Notes
Date: Sat, 9 Feb 2019 08:07:08 -0500
From: Kristen James Eberlein <kris@eberleinconsulting.com>
To: DITA TC <dita@lists.oasis-open.org>


Latest template for committee notes.

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)



-------- Forwarded Message --------
Subject: Re: [dita] Re: Changes in the new design for OASIS Committee Notes
Date: Tue, 5 Feb 2019 14:19:34 -0500
From: Paul Knight <paul.knight@oasis-open.org>
To: Chet Ensign <chet.ensign@oasis-open.org>
CC: Kristen James Eberlein <kris@eberleinconsulting.com>


Hi Chet and Kris,

I'm attaching the new templates for Notes in MS-Word (DOCX) format.
These use Liberation Sans and Liberation Mono for almost all styles.

I think that the font sizes used here are the ones we will want to use for the DITA Notes. I think that the fractional font sizes Kris found in the PDF from Chet are an artifact of the PDF generation. I don't think we've used fractional fonts in the editable templates (MS-Word and Open Office).

Best regards,
Paul


On Thu, Jan 31, 2019 at 12:15 PM Paul Knight <paul.knight@oasis-open.org> wrote:
Sounds like we're interested in common goals here.ÂÂ

We are investigating the use ofÂLiberation Sans as a replacement for Arial, Calibri, Cambria, and similar fonts.
Basic background here:
Liberation Sans seems to be a free and widely-available replacement for Arial (see for instance https://en.wikipedia.org/wiki/Arial#Free_alternatives)
It appears to be bundled with Open Office, LibreOffice, MS-Word. (On my system, anyway).
There's more detail on the Liberation fonts at:Âhttps://en.wikipedia.org/wiki/Liberation_fonts

We're planning to assemble a Notes template based on Liberation Sans as the primary sans-serif font. (Any comments on this are welcome!)

It would be a good opportunity for us to clearly pin down font sizes, and likely other style elements which have historically been a bit neglected.

Best regards,
Paul

On Thu, Jan 31, 2019 at 11:35 AM Chet Ensign <chet.ensign@oasis-open.org> wrote:
Ditto, thanks Kris! I didn't realize we had fonts showing up in fractional sizes.Â

/chet

On Thu, Jan 31, 2019 at 11:26 AM Paul Knight <paul.knight@oasis-open.org> wrote:
Hi Kris and all,

Thanks for assembling this so clearly! It's very useful to consider several of these items together.

I'll dig into this and see what the next steps might be.

Best regards,
Paul

On Thu, Jan 31, 2019 at 10:17 AM Kristen James Eberlein <kris@eberleinconsulting.com> wrote:

Hi, Paul.

I'm comparing the PDF that Chet sent in November with what we we have in our current style sheets. Here are the changes that I identify:

Change
Notes
Comments/Things we need from OASIS
New header for cover page. Includes:
  • New logo
  • The text "OASIS Committee Note"
  • A line
Text = Arial, 18 pt bold, #707070

Line = ?
  • High-quality version of the logo
  • Specifications for the line: Color and thickness
Cover page titles
Text = Arial (replace Cambria), bold, #446CAA (replace #?)

Various font weights:
Note Title Version = 24 pt
Committee Note Draft NN = 18pt (replace 16 pt, add bold)
Specification URIs = 12 pt (replace 14 pt, eliminate padding below)
...
OASIS: I am going to change the fonts and colors, but largely leave the font sizes as is. Then let's look at the results and see what you think.

It does not look like the PDF that you sent us is a final design; it has less-than-ideal font sizes (10.80 pt and 8.88 pt) and padding for elements.

Can we standardize font sizes to use whole numbers?


Sidebar on cover page
Remove

Footer on cover page
Add; the old design did not have the footer.

Footer
Render copyright statement on a single line; bottom aligned

Header
Remove

Body titles
Text = Arial (replace Cambria) bold
H1 = 18 pt
H2 = 13.92 pt (replace 14 pt)
H3 = 12.96 pt
H4 = Not defined
Can we standardize font sizes to use whole numbers?
Body text
Calilbri 10.80 pt

Footer text
Calibri 8.88 pt


Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)

On 1/28/2019 10:47 AM, Kristen James Eberlein wrote:

FYI. Forwarding to the list so that I can reference this in a GitHub issue.

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)



-------- Forwarded Message --------
Subject: New design for OASIS Committee Notes
Date: Wed, 28 Nov 2018 16:54:54 -0500
From: Chet Ensign <chet.ensign@oasis-open.org>
To: Staff Bizdev <staff-bizdev@lists.oasis-open.org>, OASIS TAB <tab@lists.oasis-open.org>, Paul Knight <paul.knight@oasis-open.org>, Ashok Malhotra <malhotrasahib@gmail.com>, Kristen James Eberlein <kris@eberleinconsulting.com>, G. Ken Holman <gkholman@cranesoftwrights.com>, dave.lemire <dave.lemire@g2-inc.com>


Hi folks,Â

After reviewing possible designs for a new Committee Note with the TAB and several interested members, we have settled on the attached. This eliminates the fat blue bar that took up the so much real estate on the first page and the header that reminded you, page after page, that THIS ISN'T STANDARDS TRACK! Oye vey.Â

Instead, it uses a label, just under the OASIS logo, to identify this as a Committee Note and it states in the Status section that the patent provisions of the OASIS process don't apply. It is cleaner, matches our new color scheme, and makes Committee Notes less like ugly step children.Â

Ken, Kris, Dave, let us know what information you want regarding colors, etc. Paul, let's go ahead and update the cover page template when you get a chance.Â

--

/chetÂ
----------------
Chet Ensign
Chief Technical Community Steward
OASIS: Advancing open standards for the information society
http://www.oasis-open.org

Primary: +1 973-996-2298
Mobile: +1 201-341-1393Â

---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that 
generates this mail.  Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php 


--
Paul Knight....Document Process Analyst...mobile: +1 781-883-1783
OASIS - Advancing open standards for the information society


--

/chetÂ
----------------
Chet Ensign
Chief Technical Community Steward
OASIS: Advancing open standards for the information society
http://www.oasis-open.org

Primary: +1 973-996-2298
Mobile: +1 201-341-1393Â


--
Paul Knight....Document Process Analyst...mobile: +1 781-883-1783
OASIS - Advancing open standards for the information society


--
Paul Knight....Document Process Analyst...mobile: +1 781-883-1783
OASIS - Advancing open standards for the information society

Attachment: Note-FrontMatter-DOCX-v2019.02-Lib.docx
Description: application/vnd.openxmlformats-officedocument.wordprocessingml.document

Attachment: Note-WD-Starter-DOCX-v2019.02-Lib.docx
Description: application/vnd.openxmlformats-officedocument.wordprocessingml.document

---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that 
generates this mail.  Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php 


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]