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
