[Openstack-docs] Convention on <screen> use

Summer Long slong at redhat.com
Mon Mar 24 09:56:27 UTC 2014


Unless there are comments, I prefer one screen. Always seems to just add bloat otherwise, and it's not what the user actually sees. 

Just 2 cents though, 
Summer 

-- 
Summer Long 
OpenStack Documentation Lead 
Engineering Content Services 

Red Hat Asia Pacific 
Brisbane, Austral ia 
slong at redhat.com | irc: slong 

----- Original Message -----

> From: "Anne Gentle" <anne at openstack.org>
> To: "Andreas Jaeger" <aj at suse.com>
> Cc: "openstack-docs" <openstack-docs at lists.openstack.org>
> Sent: Friday, March 21, 2014 11:15:24 PM
> Subject: Re: [Openstack-docs] Convention on <screen> use

> On Fri, Mar 21, 2014 at 3:52 AM, Andreas Jaeger < aj at suse.com > wrote:

> > On 03/20/2014 09:37 PM, Diane Fleming wrote:
> 
> > > But I'm willing to go along with the consensus on this. And I totally
> 
> > > agree that we need to have one convention that we all use.
> 
> > >
> 
> > > But here's why I like two screens:
> 
> > >
> 
> > > 1. You can insert text between the user input and the computer output,
> 
> > > such an explanation of what the user might see in the output.
> 

> > You still can do this, I see no problem with that.
> 

> In the Ops Guide, we standardized on one screen wrapping <userinput> and
> <computeroutput> but even so it was causing oddities with their transforms.

> I'd prefer <screen> around each.

> Thanks,
> Anne

> > Andreas
> 
> > --
> 
> > Andreas Jaeger aj@{ suse.com , opensuse.org } Twitter/Identica: jaegerandi
> 
> > SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
> 
> > GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
> 
> > GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126
> 

> > _______________________________________________
> 
> > Openstack-docs mailing list
> 
> > Openstack-docs at lists.openstack.org
> 
> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
> 

> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20140324/9f7c65da/attachment.html>


More information about the Openstack-docs mailing list