Bug 747528 - Zanata Quickstart Guide - showing programmer comment in legal notice
Summary: Zanata Quickstart Guide - showing programmer comment in legal notice
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Zanata
Classification: Retired
Component: Component-Docs
Version: unspecified
Hardware: Unspecified
OS: Unspecified
unspecified
medium
Target Milestone: ---
: ---
Assignee: David O'Brien
QA Contact: Ding-Yi Chen
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2011-10-20 07:22 UTC by IanNeilsen
Modified: 2016-05-26 13:36 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Environment:
Last Closed: 2013-11-27 03:31:54 UTC
Embargoed:


Attachments (Terms of Use)

Description IanNeilsen 2011-10-20 07:22:06 UTC
Description of problem:

On the first page of the Zanata Quickstart Guide, under the Legal Notice Heading, the very first sentence of the Legal Notice after the copyright term, you will notice a devel comment following the copyright year.

devel comment reads (| You need to change the HOLDER entity in the en-US/Zanata_User_Guide.ent file |)

This should be removed and the document updated


Version-Release number of selected component (if applicable): Edition 0


How reproducible:


Steps to Reproduce:
1.
2.
3.
  
Actual results:


Expected results:
the dev comment should not have made it through to the first edition of the zanata guide

Additional info:

Comment 1 Michelle Kim 2012-11-06 00:46:58 UTC
I just verified the bug in http://zanata.org/docs/Zanata_Quickstart_Guide/html/index.html 

Legal Notice
Copyright © 2011 | You need to change the HOLDER entity in the en-US/Zanata_User_Guide.ent file | 

Josh or anyone in Zanata team,
Can you please do a quick removal of the developer comments, so that we can resolve this bug? Thanks.

Michelle

Comment 2 David O'Brien 2013-04-11 11:18:30 UTC
As far as I know Zanata docs are only being maintained in the wiki now, not in DocBook. If this is true, this bug is a Won't Fix. If this is false, ... I'll have to talk to somebody about moving forward with Zanata doc.

If the DocBook versions of the Zanata docs are all covered by Wiki material, perhaps we should remove them from display?

Comment 3 Sean Flanigan 2013-04-12 04:43:48 UTC
> If the DocBook versions of the Zanata docs are all covered by Wiki material, perhaps we should remove them from display?

The DocBook info would need to be migrated to the wiki first.

Comment 4 David O'Brien 2013-08-06 14:54:59 UTC
I've been given an archive of DocBook XML files of the QuickStart Guide from which to work. The latest build of these is here:

http://file.bne.redhat.com/~daobrien/Zanata/Quickstart%20Guide/

The Legal Notice has been corrected (it's just a boiler plate entry that needs to get updated whenever you create a new book).

As soon as I get confirmation of where to put these and how (github somewhere) I'll do that, so that they're under version control.

Comment 5 Ding-Yi Chen 2013-09-13 00:41:08 UTC
VERIFIED with Revision 1.0.0-1	Fri Aug 02 2013	Joshua Wulf

Comment 6 Sean Flanigan 2013-11-27 03:31:54 UTC
Closing VERIFIED bugs which predate Zanata 3.1.2.


Note You need to log in before you can comment on or make changes to this bug.