[
https://jira.duraspace.org/browse/DS-1036?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=22659#comment-22659
]
Robin Taylor commented on DS-1036:
----------------------------------
I have deleted the html version of the docs and moved the pdf up one level so
it now sits directly under docs. Personally I quite like a docs folder as it is
a convention I am used to, but I'll happily delete it and move the pdf into the
root folder if anyone would prefer.
I would also quite like delete the docs/README, CHANGES, and KNOWN_BUGS and
update the general README to include pointers to where relevant info can be
found (Jira, Wiki etc). Any objections ?
> Cleanup Documentation and README files (Maintaining HTML Docs in SVN creates
> "merge noise" for enduser developers.)
> -------------------------------------------------------------------------------------------------------------------
>
> Key: DS-1036
> URL: https://jira.duraspace.org/browse/DS-1036
> Project: DSpace
> Issue Type: Task
> Affects Versions: 1.7.2, 1.8.0
> Reporter: Mark Diggory
> Assignee: Robin Taylor
> Fix For: 1.8.0
>
>
> I recommend we drop storing html versions of the documents in the SVN.
> Having these here creates merge noise when they are regenerated across
> versions. Using the PDF seems sane.
> Likewise, I recommend that the following file contents be consolidated into
> the documentation and removed from Source.
> http://scm.dspace.org/svn/repo/dspace/trunk/dspace/docs/postgres-upgrade-notes.txt
> Possibly recommend getting rid of some of the "docs" directory structure and
> instead put one PDF copy of Documentation at top level of project.
> Other recommendations for consolidating READMEs and Documentation Welcome....
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:
https://jira.duraspace.org/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
------------------------------------------------------------------------------
All of the data generated in your IT infrastructure is seriously valuable.
Why? It contains a definitive record of application performance, security
threats, fraudulent activity, and more. Splunk takes this data and makes
sense of it. IT sense. And common sense.
http://p.sf.net/sfu/splunk-d2dcopy2
_______________________________________________
Dspace-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/dspace-devel
