[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