Hey Michelle,
Thanks for the excellent feedback. I'll give it some thought. :)
Layne
Michelle Olson wrote:
>
> Hiya Layne,
>
> Thanks for sending these out, great stuff to update the old way of handling
> /etc/dfs/dfstab! I really like the descriptions of
the sub-commands with examples of each, it provides very nice introduction to
the new commands that gives me an overview that I can
easliy grasp right away. I also really like that you link to all the tasks that
use the new sharemgr command from these
descriptions--your use of linking throughout just makes me happy. Couple of
things that I thought of in the initial read-through:
>
> Indexing: sharemgr is not indexed under Commands or Utilities yet.
> Linking: you don't yet have a live link to the sharemgr man page.
> (As a sideline, this might be a technical issue with the link mgr database
> for a beta document, right? If so, maybe you could
describe this a bit for us to give a window into what you're doing with linking
in the beta phases--just if you have time-- I
thought this an interesting topic germaine to all of us who write heavily
linked documents)
> Tasks: I like that you incorporate this new set of commands into a full task
> to demonstrate the use case, I do think that I want
another step at the end, though, to understand better what I get from the NFS
server logging. See below for a discussion of what I
mean.
>
> Thanks again for sending this out!
> Much appreciated,
> Michelle
>
> More on the extra task step: Something that says, 'you'll be able to monitor
> thus-and-so activity by viewing logs in directory XYZ
if the daemon is running'. Then, to take it a step further, you can talk about
how having the new sharemgr utility enables you to
better automate changes to your logging setup if, say, you want it configured
one way during the day and a different way during the
night.
>
> This example might not make perfect sense for this case, but where I'm going
> is helping folks understand how they can get power
out of the utility, because a lot of folks who know the old ways of editing
/etc/dfs/dfstab manually will continue to do it that way
if there is no prevailing reason to change. At least *I'm* that way :) I know
my little wificonfig and ifconfig commands and I
refuse to download inetmenu to automate what I've already memorized, probably
because I don't understand the other benefits I might
get from it.
>
> Probably not apples to apples comparison of things, but I hope it helps you
> to think of casting the sharemgr in another way that
builds on your current introduction ('previously, you had to manually edit
/etc/dfs/dfstab') by telling folks not only how their
task steps change, but where they'll gain some automation, efficiency,
standardization, or usability with the new command set.
>
>
> This message posted from opensolaris.org
> _______________________________________________
> docs-discuss mailing list
> docs-discuss at opensolaris.org
