[Dspace-devel] Tables in configuration doco. are hard to read
https://wiki.duraspace.org/display/DSDOC3x/Configuration These are a kind of multilevel table: three rows make up one complete entry. There's no distinction among the rows so it's hard to scan down the entries. Elsewhere in the documentation I've seen such tables formatted with a highlight on the first line of each entry. I'd like to suggest doing that on the Configuration page. -- Mark H. Wood, Lead System Programmer mw...@iupui.edu Asking whether markets are efficient is like asking whether people are smart. pgpuv8dWcG4lA.pgp Description: PGP signature -- Don't let slow site performance ruin your business. Deploy New Relic APM Deploy New Relic app performance management and know exactly what is happening inside your Ruby, Python, PHP, Java, and .NET app Try New Relic at no cost today and get our sweet Data Nerd shirt too! http://p.sf.net/sfu/newrelic-dev2dev___ Dspace-devel mailing list Dspace-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/dspace-devel
Re: [Dspace-devel] Tables in configuration doco. are hard to read
Hi Mark, I've updated the statistics configuration docs the other day, and I noticed the same issue, that the configurations all get lost in a big mess of repeated content. To the statistics page, I inserted a blank row in the table between entries. If bold/highlighting is clearer, then we can go that direction. Peter Dietz On Thu, Oct 11, 2012 at 10:34 AM, Mark H. Wood mw...@iupui.edu wrote: https://wiki.duraspace.org/display/DSDOC3x/Configuration These are a kind of multilevel table: three rows make up one complete entry. There's no distinction among the rows so it's hard to scan down the entries. Elsewhere in the documentation I've seen such tables formatted with a highlight on the first line of each entry. I'd like to suggest doing that on the Configuration page. -- Mark H. Wood, Lead System Programmer mw...@iupui.edu Asking whether markets are efficient is like asking whether people are smart. -- Don't let slow site performance ruin your business. Deploy New Relic APM Deploy New Relic app performance management and know exactly what is happening inside your Ruby, Python, PHP, Java, and .NET app Try New Relic at no cost today and get our sweet Data Nerd shirt too! http://p.sf.net/sfu/newrelic-dev2dev ___ Dspace-devel mailing list Dspace-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/dspace-devel -- Don't let slow site performance ruin your business. Deploy New Relic APM Deploy New Relic app performance management and know exactly what is happening inside your Ruby, Python, PHP, Java, and .NET app Try New Relic at no cost today and get our sweet Data Nerd shirt too! http://p.sf.net/sfu/newrelic-dev2dev___ Dspace-devel mailing list Dspace-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/dspace-devel
Re: [Dspace-devel] Tables in configuration doco. are hard to read
Hi Mark Peter, The Wiki editor has an option to highlight specific rows (or columns) in tables. I'd agree it might be good to use this to make the Config docs easier to read. Just do the following: * Edit the page * Select the Row you wish to highlight * A table menu appears...one of the options allows you to highlight that row in a variety of colors. Likely we just want to highlight things in grey. Here's the various table options from the Confluence docs: https://confluence.atlassian.com/display/DOC/Working+with+Tables As an example, I just did that on the first few sections of the Config docs: https://wiki.duraspace.org/display/DSDOC3x/Configuration#Configuration-Thedspace.cfgConfigurationPropertiesFile If someone has the time in the next few days to take this over, I'd appreciate it! - Tim On 10/11/2012 9:55 AM, Peter Dietz wrote: Hi Mark, I've updated the statistics configuration docs the other day, and I noticed the same issue, that the configurations all get lost in a big mess of repeated content. To the statistics page, I inserted a blank row in the table between entries. If bold/highlighting is clearer, then we can go that direction. Peter Dietz On Thu, Oct 11, 2012 at 10:34 AM, Mark H. Wood mw...@iupui.edu mailto:mw...@iupui.edu wrote: https://wiki.duraspace.org/display/DSDOC3x/Configuration These are a kind of multilevel table: three rows make up one complete entry. There's no distinction among the rows so it's hard to scan down the entries. Elsewhere in the documentation I've seen such tables formatted with a highlight on the first line of each entry. I'd like to suggest doing that on the Configuration page. -- Mark H. Wood, Lead System Programmer mw...@iupui.edu Asking whether markets are efficient is like asking whether people are smart. -- Don't let slow site performance ruin your business. Deploy New Relic APM Deploy New Relic app performance management and know exactly what is happening inside your Ruby, Python, PHP, Java, and .NET app Try New Relic at no cost today and get our sweet Data Nerd shirt too! http://p.sf.net/sfu/newrelic-dev2dev ___ Dspace-devel mailing list Dspace-devel@lists.sourceforge.net mailto:Dspace-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/dspace-devel -- Don't let slow site performance ruin your business. Deploy New Relic APM Deploy New Relic app performance management and know exactly what is happening inside your Ruby, Python, PHP, Java, and .NET app Try New Relic at no cost today and get our sweet Data Nerd shirt too! http://p.sf.net/sfu/newrelic-dev2dev ___ Dspace-devel mailing list Dspace-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/dspace-devel -- Don't let slow site performance ruin your business. Deploy New Relic APM Deploy New Relic app performance management and know exactly what is happening inside your Ruby, Python, PHP, Java, and .NET app Try New Relic at no cost today and get our sweet Data Nerd shirt too! http://p.sf.net/sfu/newrelic-dev2dev ___ Dspace-devel mailing list Dspace-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/dspace-devel
Re: [Dspace-devel] Tables in configuration doco. are hard to read
On Thu, Oct 11, 2012 at 10:05:38AM -0500, Tim Donohue wrote: The Wiki editor has an option to highlight specific rows (or columns) in tables. I'd agree it might be good to use this to make the Config docs easier to read. [snip] As an example, I just did that on the first few sections of the Config docs: https://wiki.duraspace.org/display/DSDOC3x/Configuration#Configuration-Thedspace.cfgConfigurationPropertiesFile If someone has the time in the next few days to take this over, I'd appreciate it! Done! -- Mark H. Wood, Lead System Programmer mw...@iupui.edu Asking whether markets are efficient is like asking whether people are smart. pgpsdU3y9jCi1.pgp Description: PGP signature -- Don't let slow site performance ruin your business. Deploy New Relic APM Deploy New Relic app performance management and know exactly what is happening inside your Ruby, Python, PHP, Java, and .NET app Try New Relic at no cost today and get our sweet Data Nerd shirt too! http://p.sf.net/sfu/newrelic-dev2dev___ Dspace-devel mailing list Dspace-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/dspace-devel
