How to create a proven practice document

VERSION 5 Published

Created on: Sep 7, 2008 10:19 AM by Steve Chambers - Last Modified:  Oct 23, 2009 7:50 AM by Steve Chambers

Here's the lightweight process

 

1. Find the community that fits your practice (don't worry if you get it wrong, the community folks will help find the right home)

 

2. Create a document

participate now.png

 

 

3. Then select "Write a new document"

Picture 5.png

 

4. Put your content in, make it look like the template below (click on example to enlarge). There is a template at the bottom of this doc that you can copy & paste with to save you writing this out

write document.png

 

5. After you've written the document, you can do a number of things:

 

  • Attach a document - this can be instead of writing out content in the main doc (but always add the headers above).

  • ALWAYS add Tags. The minimum is "proven_practice", but check out some of the others to get an idea. Product names, job roles, company names, busines verticals - these are all good tags.

  • If you are going to Submit for Approval straight away, then leave "Users who may edit:" set as "Anyone" - this is a collaboration site - and click "Submit for Approval"

  • If you want to keep this as a draft and work with someone on this prior to publishing, then in "Users who may edit" select the other VIOPS user(s) - and click "Save as Draft"

  • Always leave Comments open.

 

metadata.png

 

6. Wait for the approver to get in touch about adding more content

 

 

The template for copying & pasting

Paste the following into your document.

 

Introduction

explain why this proven practice came about, what problem does it solve?

 

 

Intended Audience

what kind of organization would this suit? - company size, business vertical, size of virtual infrastructure- which job roles will be interested in this - a VCP? A CCNA? An IT Manager? A Change Manager? Head of Operations?

 

Outline

briefly list the steps in the practice, in number order

 

Author

company logo + bio- author(s) name, email, bio

 

Resources

link to this document as a minimum- other links to white papers, KB articles, case studies, VMTN etc.

 

Disclaimer

You use this proven practice at your discretion. VMware and the author do not guarantee any results from the use of this proven practice. This proven practice is provided on an as-is basis and is for demonstration purposes only.

 

Title of proven practice goes here

...and the unambiguous, prescriptive and actionable text goes here

Average User Rating
(1 rating)




There are no comments on this document

More Like This

  • Retrieving data ...