Wednesday Sep 30, 2009

Communications Suite Wiki: Seek and Ye Shall Find

I wanted to address an issue that comes up from time to time with documentation for anything: how do you find what you are looking for? And do it quickly? The wikis.sun.com model provides a number of ways to get to information:

  • You can browse by page, label, and recent updates.
  • You can use the global search, for all wiki spaces, or the site-specific search, which we provide on every page of our Communications Suite wiki sites.
  • Yes, you can still google for information, but my recommendation is to use the wikis.sun.com specific ways of getting to the information. Indeed, I find the wikis.sun.com search to be quite fast and effective in finding what I'm looking for.
I put together a summary of the various ways to find the information you are seeking. Give it a read: Finding What You Are Looking For

 I do realize that as a writer of this information, I'm at an advantage, knowing where everything is. It is my job to make it easy for the community to also know where everything is. So leave a comment if you have suggestions for how to improve our wiki docs model, especially if you are having difficulty locating particular information.

Monday Sep 28, 2009

Lip Dubbing, the Future of Technical Communications?

This very cool lip dub:

Led me to What does this have to do with Technical Communication?:

Everything. We need to incorporate more audiovisual media into instructional documentation. Users love this type of content. Voice on video doesn’t need to be recorded in a studio. Our screen demos don’t need to be storyboarded to death, requiring 75 hours to produce a two minute video. As long as the content is there, on target, in sync with user needs, it will fulfill the user’s desire. As tech writers, we should be creating more video — amateur is acceptable. Personal voice is desirable. Bloopers give human appeal. If we can have fun doing it [truly], it will engage our audience even more.

So, any suggestions for the first tune for Communications Suite?

Monday Aug 25, 2008

Zip it on docs.sun.com

This one slipped through my radar, since we moved our docs to wikis.sun.com for Communications Suite 6.

Still, if you want to try it for Communications Suite 5 docs, here's your link:

http://docs.sun.com/app/docs/coll/1631.1

Thursday Mar 20, 2008

Comms 5 Documentation: New PDF Zip File Posted

Just to bring the Communications Suite 5 documentation story up-to-date, we've recently updated the Deployment Planning Guide, and Messaging Server Administration Guide and Reference. Accordingly, I've updated the docs PDF zip file on the Comms BigAdmin hub, where you can download all the Comms 5 docs at once. Here's the link:

http://www.sun.com/bigadmin/hubs/comms/files/COMMS5_DOCS.zip

About

Reporting about Unified Communications Suite Documentation, including news, Comms 101, documentation updates, and tips and tricks.

Search

Archives
« April 2014
SunMonTueWedThuFriSat
  
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
   
       
Today
https://blogs.oracle.com/factotum/category/Documentation+Issues?page=1
blogs.oracle.com
crawl=CC-MAIN-2014-15
40606
application/http; msgtype=response
sha1:NNBYGHRZ6WYVW4L7REKL3S7XZY3ICOE6
<urn:uuid:ef6d18c2-4dc4-4996-b42a-111892392922>
2014-04-21T00:37:58Z
23.6.22.140
sha1:XLQGSF6KIPKMEZFHE7RAT5GTRY7AHIHD
<urn:uuid:5c41e7f0-3255-41fe-b1ae-f1441eaa57f2>
https://blogs.oracle.com/factotum/category/Documentation+Issues?page=1
response
<urn:uuid:03a2fe82-1900-4581-a4cc-b0b486580261>
robots: classic
hostname: ip-10-147-4-33.ec2.internal
software: Nutch 1.6 (CC)/CC WarcExport 1.0
isPartOf: CC-MAIN-2014-15
operator: CommonCrawl Admin
description: Wide crawl of the web with URLs provided by Blekko for April 2014
publisher: CommonCrawl
format: WARC File Format 1.0
conformsTo: http://bibnum.bnf.fr/WARC/WARC_ISO_28500_version1_latestdraft.pdf