Showing posts with label webdesign. Show all posts
Showing posts with label webdesign. Show all posts

Thursday, 15 September 2011

Technical Writing Test

technical writing test"technical writing test"

We've Tested the new WhiteSmoke Translator

WhiteSmoke Translator 2011 is actually the new and to a great extent enhanced world leading writing software. However, is it really as good as they claim? We've looked, and tested the translations of 20 languages.

I downloaded the program, accepted the confirmation email, and I straight away did an set up. The whole process from ordering to install and using the translator software didn't take longer than 4 minutes. We straightaway started testing some of the features, and my first impression was positive. The software works with a push of the F2 button and in the pop up window you immediately see your grammar and style errors.

The truth is actually, most of us all communicate in a rush these times, and we fall into our established writing routines - similar sentence arrangements, non-standard speech or informal language, as well as the same old language. The writing software addresses these issues with the help of their impressive style checking as well as text enrichment - it is the leading tool for sifting through written communication style at your disposal these days. A quick style check with WhiteSmoke prior to sending any written document will help you enrich your text with synonyms and alternate phrasing, helping you to write in a more varied and powerful way.

The interface would definitely be useless though if WhiteSmoke translator didn't translate correctly. Fortunately, it gets it right when it comes to translation. In reality, it conducted the best out of all the software programs in our rewriting tests. That particular quality is really exactly what cinches the trade, WhiteSmoke translator is the most outstanding translation software that we could acquire. The software system is the most effective translation program out there simply because it offers the most accurate translations. Based on Applied mathematics Machine Translation (SMT) technology, the translation quality of WhiteSmoke Translator is actually very elevated, surpassing competitive solutions on the market.

The software integrates very well with just about all Windows and Mac applications; all you have to do is press F2 and right-click on any kind of word and the product will mechanically look up the text in their dictionaries and offer several numerous authorities for additional information. When you need to translate much more than 1 word, you just accent the copy prior to pressing Control and right-clicking. You can also copy and paste text straight into it.

WhiteSmoke can be used alongside your current word processor and is engineered for both non-native as well as native English speakers. It is particularly practical if you are a non-native speaker or have trouble writing.

The device is available in numerous different packages tailored to suit your requirements. I can see that they seem to be aiming it at IT specific (e.g. blog writers) and students/pupils that want help with their essay writing.

This is not to state that anyone will benefit from this program. With a much more sophisticated spell and grammar checker compared to Word WhiteSmoke appears to pick up far better on grammatical and sentence structure errors than Word does.

I can easily understand the product being of specific use to people who has recently started a new job, for instance, and needs help with business or technical writing, for instance. Visually, it is very impressive, and it is very simple to use. The only instance in which I would definitely say WhiteSmoke is not useful would be if you currently had a fairly good standard of English language and an up to date word processor.

WhiteSmoke is available in the following models:

The Normal Writing profile is actually the perfect introduction to the world of WhiteSmoke Translator! This version includes the core grammar checker, spell checker, and style enhancement features common to all WhiteSmoke versions, and a dictionary-thesaurus and spelling database suitable for general writing needs.

The Business Writing profile is designed for all your enterprise writing needs! This variation contains the core grammar checker, spell checker, and style enhancement features common to all WhiteSmoke versions, and a dictionary- thesaurus and spelling database tailored for business written material.

The Creative Writing profile is the perfect variation of WhiteSmoke with regard to those writing fiction or other creative versions. This version includes the particular core grammar checker, spell checker, as well as style improvement features common to all WhiteSmoke versions, and a dictionary-thesaurus and spelling database with a wide range of entries suited to creative writing.

The Bio-Tech Writing profile is the perfect solution for healthcare experts. The variation includes the core grammar checker, spell checker, and style enhancement features common to all WhiteSmoke versions, and a huge dictionary-thesaurus and spelling database suitable for bio-tech and medical writing needs.

The Hi-Tech Writing profile can be the best precise writing remedy for hi-tech and IT experts. This version includes the core WhiteSmoke features - the grammar checker, spell checker, and style checker - and a dictionary-thesaurus and orthography database refined for hi-tech writing.

The Executive Package is the premier version associated with WhiteSmoke Translator 2011. This version includes the core grammar checker, spell checker, and style enhancement functions common to all WhiteSmoke versions, and ALL available writing profiles for the dictionary-thesaurus and spelling data bank. 

Our conclusion

Just one of the main advantages of this software is that it functions with a wide range of software applications (Even when writing on facebook or using a messenger) and offers the writer much more alternative terms and synchronic linguistics choices - to compliment their written communication - compared to just about any other program we have tried.

You can extend and correct grammar or perhaps use it for specialist proofreading, check spelling and sentence fragments on correctness, instantly look up dictionary words or just use the punctuation checker, which is honestly technologically head and shoulders higher up the others in the tournament.

WhiteSmoke translator is a entire fledged all-in-one option and the patented writing technologies. They name it Natural Language Processing, pushes writing to a new degree. Even beginners will definitively communicate better English immediately.


About the Author

Carmen works for an online publishing firm and now uses this software on a daily basis. Do you want to know more about this software? Come visit WhiteSmoke.



ClasScandal 2 Episode 3 (test namen sa technical writing)









technical writing test
technical writing test

Thursday, 1 September 2011

Technical Report Writing Standards

technical report writing standards_2"technical report writing standards"

Standard Template Library

Overview



Please help improve this article by adding reliable references. Unsourced material may be challenged and removed. (September 2007)



The STL provides a ready-made set of common classes for C++, such as containers and associative arrays, that can be used with any built-in type and with any user-defined type that supports some elementary operations (such as copying and assignment). STL algorithms are independent of containers, which significantly reduces the complexity of the library.



The STL achieves its results through the use of templates. This approach provides compile-time polymorphism that is often more efficient than traditional run-time polymorphism. Modern C++ compilers are tuned to minimize any abstraction penalty arising from heavy use of the STL.



The STL was created as the first library of generic algorithms and data structures for C++, with four ideas in mind: generic programming, abstractness without loss of efficiency, the Von Neumann computation model, and value semantics.



Contents



Containers



The STL contains sequence containers and associative containers. The standard sequence containers include vector, deque, and list. The standard associative containers are set, multiset, map, and multimap. There are also container adaptors queue, priority_queue, and stack, that are containers with specific interface, using other containers as implementation.



Container



Description



Sequences (Arrays / Linked Lists) - ordered collections



vector



a dynamic array, like C array (i.e., capable of random access) with the ability to resize itself automatically when inserting or erasing an object. Inserting and removing an element to/from back of the vector at the end takes amortized constant time. Inserting and erasing at the beginning or in the middle is linear in time.



A specialization for type bool exists, which optimizes for space by storing bool values as bits.



list



a doubly-linked list; elements are not stored in contiguous memory. Opposite performance from a vector. Slow lookup and access (linear time), but once a position has been found, quick insertion and deletion (constant time).



deque (double ended queue)



a vector with insertion/erase at the beginning or end in amortized constant time, however lacking some guarantees on iterator validity after altering the deque.



Container adaptors



queue



Provides FIFO queue interface in terms of push/pop/front/back operations.



Any sequence supporting operations front(), back(), push_back(), and pop_front() can be used to instantiate queue (e.g. list and deque).



priority_queue



Provides priority queue interface in terms of push/pop/top operations (the element with the highest priority is on top).



Any random-access sequence supporting operations front(), push_back(), and pop_front() can be used to instantiate priority_queue (e.g. vector and deque).



Elements should additionally support comparison (to determine which element has a higher priority and should be popped first).



stack



Provides LIFO stack interface in terms of push/pop/top operations (the last-inserted element is on top).



Any sequence supporting operations back(), push_back(), and pop_back() can be used to instantiate stack (e.g. vector, list, and deque).



Associative containers - unordered collections



set



a mathematical set; inserting/erasing elements in a set does not invalidate iterators pointing in the set. Provides set operations union, intersection, difference, symmetric difference and test of inclusion. Type of data must implement comparison operator < or custom comparator function must be specified. Implemented using a self-balancing binary search tree.



multiset



same as a set, but allows duplicate elements.



map



an associative array; allows mapping from one data item (a key) to another (a value). Type of key must implement comparison operator < or custom comparator function must be specified. Implemented using a self-balancing binary search tree.



multimap



same as a map, but allows duplicate keys.



hash_set



hash_multiset



hash_map



hash_multimap



similar to a set, multiset, map, or multimap, respectively, but implemented using a hash table; keys are not ordered, but a hash function must exist for the key type. These containers are not part of the C++ Standard Library, but are included in SGI's STL extensions, and are included in common libraries such as the GNU C++ Library in the __gnu_cxx namespace. These are scheduled to be added to the C++ standard as part of TR1, with the slightly different names of unordered_set, unordered_multiset, unordered_map and unordered_multimap.



Other types of containers



bitset



stores series of bits similar to a fixed-sized vector of bools. Implements bitwise operations and lacks iterators. Not a Sequence.



valarray



another C-like array like vector, but is designed for high speed numerics at the expense of some programming ease and general purpose use. It has many features that make it ideally suited for use with vector processors in traditional vector supercomputers and SIMD units in consumer-level scalar processors, and also ease vector mathematics programming even in scalar computers.



Iterators



The STL implements five different types of iterators. These are input iterators (which can only be used to read a sequence of values), output iterators (which can only be used to write a sequence of values), forward iterators (which can be read, written to, and move forward), bidirectional iterators (which are like forward iterators but can also move backwards) and random access iterators (which can move freely any number of steps in one operation).



It is possible to have bidirectional iterators act like random access iterators, as moving forward ten steps could be done by simply moving forward a step at a time a total of ten times. However, having distinct random access iterators offers efficiency advantages. For example, a vector would have a random access iterator, but a list only a bidirectional iterator.



Iterators are the major feature which allow the generality of the STL. For example, an algorithm to reverse a sequence can be implemented using bidirectional iterators, and then the same implementation can be used on lists, vectors and deques. User-created containers only have to provide an iterator which implements one of the 5 standard iterator interfaces, and all the algorithms provided in the STL can be used on the container.



This generality also comes at a price at times. For example, performing a search on an associative container such as a map or set can be much slower using iterators than by calling member functions offered by the container itself. This is because an associative container's methods can take advantage of knowledge of the internal structure, which is opaque to algorithms using iterators.



Algorithms



A large number of algorithms to perform operations such as searching and sorting are provided in the STL, each implemented to require a certain level of iterator (and therefore will work on any container which provides an interface by iterators).



Functors



The STL includes classes that overload the function operator (operator()). Classes that do this are called functors or function objects. They are useful for keeping and retrieving state information in functions passed into other functions. Regular function pointers can also be used as functors.



A particularly common type of functor is the predicate. For example, algorithms like find_if take a unary predicate that operates on the elements of a sequence. Algorithms like sort, partial_sort, nth_element and all sorted containers use a binary predicate which must provide a strict weak ordering, that is, it must behave like a membership test on a transitive, irreflexive and antisymmetric binary relation. If none is supplied, these algorithms and containers use less by default, which in turn calls the less-than-operator <.



Criticisms



Quality of compiler



The Quality of Implementation (QoI) of the C++ compiler has a large impact on usability of STL (and templated code in general):



Error messages involving templates tend to be very long and difficult to decipher. This problem has been considered so severe that a number of tools have been written which simplify and prettyprint STL-related error messages to make them more comprehensible.



Careless use of STL templates can lead to code bloat. This has been countered with special techniques within STL implementation (using void* containers internally) and by improving optimization techniques used by compilers.



Template instantiation tends to increase compilation time and memory usage (even by an order of magnitude). Until the compiler technology improves enough this problem can be only partially eliminated by very careful coding and avoiding certain idioms.



STL design issues



1. Design flaws due to limitations in the C++ language



Initialization of STL containers with constants within the source code is not as easy as data structures inherited from C (addressed in C++0x with initializer lists).



2. Perceived flaws due to the requirement to maximize speed and minimize space usage



STL containers are not intended to be used as base classes (their destructors are deliberately non-virtual); deriving from a container is a common mistake.



3. Other flaws, caused either by trade-offs in design or which have become more visible over time



The concept of iterators as implemented by STL can be difficult to understand at first: for example, if a value pointed to by the iterator is deleted, the iterator itself is then no longer valid. This is a common source of errors. Most implementations of the STL provide a debug mode which is slower but can locate such errors if used. However, at present no better replacement for iterators has been suggested and a similar problem exists in other languages, for example Java.



Certain iteration patterns do not map to the STL iterator model. For example, callback enumeration APIs cannot be made to fit the STL model without the use of coroutines, which are platform-dependent and/or unavailable, and are outside the C++ standard.



Compiler compliance does not guarantee that Allocator objects, used for memory management for containers, will work with state dependent behavior. For example, a portable library can't define an allocator type that will pull memory from different pools using different allocator objects of that type. (Meyers, p. 50)



The set of algorithms is not complete for example, the copy_if algorithm was left out by oversight (Stroustrup, p. 530) (added in C++0x: http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2666.pdf).



The interface of some containers (in particular string) is bloated (Sutter and Alexandrescu, p. 79); others are considered insufficient.



Hashing containers were left out of the original standard, but have been added in Technical Report 1, a recent extension to C++.



History



The architecture of STL is largely the creation of one person, Alexander Stepanov. In 1979 he began working out his initial ideas of generic programming and exploring their potential for revolutionizing software development. Although David Musser had developed and advocated some aspects of generic programming already by year 1971, it was limited to a rather specialized area of software development (computer algebra).



Stepanov recognized the full potential for generic programming and persuaded his then-colleagues at General Electric Research and Development (including, primarily, David Musser and Deepak Kapur) that generic programming should be pursued as a comprehensive basis for software development. At the time there was no real support in any programming language for generic programming.



The first major language to provide such support was Ada, with its generic units feature. By 1987 Stepanov and Musser had developed and published an Ada library for list processing that embodied the results of much of their research on generic programming. However, Ada had not achieved much acceptance outside the defense industry and C++ seemed more likely to become widely used and provide good support for generic programming even though the language was relatively immature. Another reason for turning to C++, which Stepanov recognized early on, was the C/C++ model of computation which allows very flexible access to storage via pointers is crucial to achieving generality without losing efficiency.



Much research and experimentation were needed, not just to develop individual components, but to develop an overall architecture for a component library based on generic programming. First at AT&T Bell Laboratories and later at Hewlett-Packard Research Labs, Stepanov experimented with many architectural and algorithm formulations, first in C and later in C++. Musser collaborated in this research and in 1992 Meng Lee joined Stepanov's project at HP and became a major contributor.



This work undoubtedly would have continued for some time being just a research project or at best would have resulted in an HP proprietary library if Andrew Koenig of Bell Labs had not become aware of the work and asked Stepanov to present the main ideas at a November 1993 meeting of the ANSI/ISO committee for C++ standardization. The committee's response was overwhelmingly favorable and led to a request from Koenig for a formal proposal in time for the March 1994 meeting. Despite the tremendous time pressure, Alex and Meng were able to produce a draft proposal that received preliminary approval at that meeting.



The committee had several requests for changes and extensions (some of them major), and a small group of committee members met with Stepanov and Lee to help work out the details. The requirements for the most significant extension (associative containers) had to be shown to be consistent by fully implementing them, a task Stepanov delegated to Musser. It would have been quite easy for the whole enterprise to spin out of control at this point, but again Stepanov and Lee met the challenge and produced a proposal that received final approval at the July 1994 ANSI/ISO committee meeting. (Additional details of this history can be found in Stevens.) Subsequently, the Stepanov and Lee document 17 was incorporated into the ANSI/ISO C++ draft standard (1, parts of clauses 17 through 27). It also influenced other parts of the C++ Standard Library, such as the string facilities, and some of the previously adopted standards in those areas were revised accordingly.



In spite of STL's success with the committee, there remained the question of how STL would make its way into actual availability and use. With the STL requirements part of the publicly available draft standard, compiler vendors and independent software library vendors could of course develop their own implementations and market them as separate products or as selling points for their other wares. One of the first edition's authors, Atul Saini, was among the first to recognize the commercial potential and began exploring it as a line of business for his company, Modena Software Incorporated, even before STL had been fully accepted by the committee.



The prospects for early widespread dissemination of STL were considerably improved with Hewlett-Packard's decision to make its implementation freely available on the Internet in August 1994. This implementation, developed by Stepanov, Lee, and Musser during the standardization process, became the basis of many implementations offered by compiler and library vendors today.



List of STL implementations



libstdc++ from gnu (was part of libg++)



STLPort, based on SGI STL



Rogue Wave standard library (HP, SGI, SunSoft, Siemens-Nixdorf)



Dinkum STL library by P.J. Plauger



Notes



^ Meyers, Scott (2005). Effective C++ Third Edition - 55 Specific Ways to Improve Your Designs. Addison Wesley. ISBN 0-321-33487-6. 



^ Sutter, Herb; Alexandrescu, Andrei (2004). C++ Coding Standards: 101 Rules, Guidelines, and Best Practices. Addison-Wesley. 



See also



List of C++ template libraries



C++0x



Boost C++ Libraries



References



Alexander Stepanov and Meng Lee, The Standard Template Library. HP Laboratories Technical Report 95-11(R.1), November 14, 1995. (Revised version of A. A. Stepanov and M. Lee: The Standard Template Library, Technical Report X3J16/94-0095, WG21/N0482, ISO Programming Language C++ Project, May 1994.)



Alexander Stepanov (2007) (PDF). Notes on Programming. http://www.stepanovpapers.com/notes.pdf.  Stepanov reflects about the design of the STL.



Nicolai M. Josuttis (2000). The C++ Standard Library: A Tutorial and Reference. Addison-Wesley. ISBN 0-201-37926-0. 



Scott Meyers (2001). Effective STL: 50 Specific Ways to Improve Your Use of the Standard Template Library. Addison-Wesley. ISBN 0-201-74962-9. 



Al Stevens (March 1995). "Al Stevens Interviews Alex Stepanov". Dr. Dobb's Journal. http://www.sgi.com/tech/stl/drdobbs-interview.html. Retrieved 2007-07-18. 



Bjarne Stroustrup (2000). The C++ Programming Language (3rd ed.). Addison-Wesley. ISBN 0-201-70073-5. 



Herb Sutter and Andrei Alexandrescu (2005). C++ Coding Standards. Addison-Wesley. ISBN 0-321-11358-6. 



David Vandevoorde and Nicolai M. Josuttis (2002). C++ Templates: The Complete Guide. Addison-Wesley Professional. ISBN 0-201-73484-2. 



Matthew Wilson (February 2004). "Callback Enumeration APIs & the Input Iterator Concept". Dr. Dobb's Journal. http://www.ddj.com/cpp/184401766. 



Atul Saini and David R. Musser, STL Tutorial and Reference Guide: C+ + Programming with the Standard Template Library. Foreword by Alexander Stepanov; [Copyright Modena Software Inc.] Addison-Wesley ISBN 0-201-63398-1



External links



STL programmer's guide official guide from SGI



STL Reference lists STL containers and their members



C/C++ reference includes a section on the STL



Apache (formerly Rogue Wave) C++ Standard Library Class Reference



Apache (formerly Rogue Wave) C++ Standard Library User Guide



Bjarne Stroustrup on The emergence of the STL (Page 5, Section 3.1)



STLPort, a very popular open-source implementation of the STL



Categories: C++ standard library | Generic programmingHidden categories: Articles needing additional references from September 2007 | All articles needing additional references | Wikipedia articles needing style editing from April 2008 | All articles needing style editing | Articles lacking in-text citations from April 2009 | All articles lacking in-text citations
About the Author

I am a professional writer from China Quality Lighting, which contains a great deal of information about fertilizer fish emulsion , wholesale spray paint, welcome to visit!



FLSA Webcast









technical report writing standards
technical report writing standards
technical report writing standards

Friday, 20 May 2011

Write Website

write website"write website"
How do I CORRECTLY write the name of a website in an essay?

such as: According to abortionfacts.com, one out of every three teenagers will have an abortion.

Would I need to underline the website, or do something else to it, or can I write the website in just like that?
this is for a college in-class essay BTW


Just underline it, like you would with a book.


How to Create Web Pages Using HTML : How to Write an HTML Hyperlink









write website
write website

Sunday, 8 May 2011

Bad Technical Writing

bad technical writing"bad technical writing"
Writers: is reading too many reference books bad?

I'm a writer, and I've been reading a lot of books about writing (mainly fiction/screenwriting, etc.) but I'm starting to believe that I am digesting (for lack of a better term) way too much information. It's like reading a bunch of technical prose on something that should be done from the heart.

Does anyone agree with this? Can reading too many reference and 'how-to' books become bad? Is the old adage "You learn to write by writing" true?


I totally know where you're coming from. I ALMOST asked this question a few days ago, but didn't because of something shiny I saw in the other room (or something... I don't know... SQUIRREL!)

So yeah, I was wondering the same thing. As I began a writing exercise, I questioned my intuition because of the writing books I've read. Then I wondered if that was a good thing or a bad thing. Was I squashing my creativity? Or was I recognizing an area where I could improve?

I really don't know for sure. I strongly believe, though, that you learn to write by writing, but I've learned priceless stuff from various how-to books, that really help when I'm in a jam. As long as you're still writing, I think how-to books are okay, but they should be supplements, not replacements. But nothing should replace daily writing exercises or writing for your stories.

Hope that helps!


ENG 352 Technical Writing - 03 - Ability to Critique









bad technical writing
bad technical writing

Saturday, 2 April 2011

Sample Report

sample report"sample report"
Where can I find a sample lab report for fast plants?



Go to link #1 and download the booklet. * Download a 32-page booklet, containing complete instructions for activities at each life cycle stage (includes important background information about plant physiology and how to grow Fast Plants).

Growing plants can actually be fun!


KFMB Sample U report









sample report
sample report
sample report

Sunday, 6 March 2011

Instructional Design And Technical Writing

Great Technical Writing: How Small Companies Can Create Great User Documents

Overview


Your product needs User Documentation (manuals, instructions, etc), but your small company (20 to 100 employees) has no in-house staff to create that documentation. This article describes how to select and enable your "non-writer" employees to create Great User Documentation. You NEED Great User Documents


Your Product needs Great User Documents (Instruction Manuals, User Guides, Reference Manuals, Instruction Sheets, etc. ):


. Undocumented features become expensive flaws . All products have shortcomings; Great User Documents help your Users around these problems . Providing information beyond the minimum helps reduce technical support costs


Your Users deserve Great User Documents:


. To eliminate jumps in the documentation that the User cannot follow . To understand what the product will do and how it performs . To provide tips and knowledge to provide the best possible User experience


Great User Documentation will reduce support costs, increase User satisfaction, and increase your profit (fewer returns and more positive recommendations).


But You Have No Writing Staff


Yes you do! If you can find employees who are between projects, or want to take on additional responsibilities and acquire new skills, then these can be your writing staff.


However, you may be considering hiring an outside freelance writer. Perhaps that is a good choice. However, let me list some benefits of using in-house non-writers over freelance writers:


. Experience with the company (culture, management, style, physical plant) . Knowledge of the product, market, users . They may know the members of the design and development teams . Already set up with resources in your company (desk, phone, access to information resources) . Will be a resource you can use to upgrade or create new documentation . Will effectively employ someone who is between projects


Selecting Who Will Write


Ask your staff if they would like to write the User Document for a particular product:


. If you have any volunteers, then these are the employees you should consider to become your writers. . If you do not have any volunteers, then you might have to resort to coercion. Perhaps explain the benefits of writing versus other less-attractive busywork (or even temporary layoffs). . If necessary, assign someone or a group to the writing task.


Convincing Your New Writers


. Tell them that you will provide support, training, and time to do the writing. Make sure that you keep your promises. . Tell them that writing skills would benefit their career (communication skills are usually a benefit) . Variety will make their work more interesting . You will try to make this as no-risk as possible . Tell them that the Great User Document that they produce will benefit the product and the company (and them).


If they have other objections to the writing assignment, evaluate their objections, and determine if you have a reasonable argument to overcome their objections. If not, perhaps you had better find someone else for the writing project.


You Can Enable Non-Writers to Write


Most of your employees who have made it through an education system, and have been hired by your company, can probably write. They may be fearful of writing. I believe that if they can think clearly and explain something verbally to someone sitting next to them, then they can write Great User Documents.


To just thrust a writing assignment on the non-writer is unfair and will prove to be unproductive. You need to support the new writer.


How to Support Your New Writers


Training


. They need a complete method for writing. They need guidance on how to start, what tools they should use, and a method for producing great User Documents. . They need an effective organization for the User Document. They need to know what to include in the User Document and how to structure the document . They need an easy way to write the first drafts and how to revise them . They need a way to feel comfortable performing the previously stressful task of writing. Most people remember an adversarial relationship between themselves as writer and their reader (usually a teacher or critic). . They do NOT need grammar lessons. Hire an editor, and if cost-conscious, hire one from a university. See the editing article in the on the site listed in the "Resources" or "About the Author" section of this article.


Support:


. Access to the development and marketing teams; . Use of the development team to evaluate their writing (small chunks); . Access to the product, literature, marketing materials.


Resources:


. Style manual; . Editor; . Time to do a good job


The resource links in the "Resources" or "About the Author" section of this article will help your new writer get going.


Beware of Technical Lures


If your new writers come from your technical areas, they may want to spend time learning writing technology. They do not need it!


My point is not to spend the time learning new tools that might not benefit your company's situation. Let's look at the two popular lures:


1. Fancy Writing Software


Very few professional technical writers would use a word processor to create a large User Document. However, in all likelihood you will NOT be creating a mammoth User Document. Most likely your User Document will be less than 40 pages. A modern word processor (such as Microsoft Word, WordPerfect or Lotus WordPro, all are trademarks) will easily do the task.


2. Content Management System (CMS)


I believe that the documentation industry has incorrectly focused itself on Content Management Systems (CMS's). CMS's are reasonable tools for large companies like Microsoft, IBM, and Toyota who have huge numbers of documents. For smaller companies (like yours), CMS's are a diversion from the real task, which is "how to produce the User Documentation that your product needs and your Users deserve."


Aha! Your new writer might say that by writing in XML or by using a CMS he/she will be able to create the text in one format and easily produce that text in HTML, printed form, or as a PDF (Portable Document Format, used by the Adobe Reader). This is not a valid argument for your situation. Modern word processors have the capability of producing HTML documents, converting their output to PDF, as well as printing.


Another argument is that a CMS will enable writers to re-use content from one product to another. I believe that this argument is not relevant to companies with only a few products. While old-fashioned, a good library system and using cut and paste will suffice for the smaller company.


Instead, Focus On These


Rather than spending time learning new technology that may or may not help your writing project, your writers (in fact, all writers) should be focusing on what is important to the Users of your product. These are:


. Content: The material that you will provide in your User Document . Access to that Content: Enabling your Reader to easily find what he/she needs at the time, and to skip what is not needed


If your new writers do know how to use writing tools such as FrameMaker (tm) or a Content Management System (and one is set up) then of course they should use these tools. But everyone should remember that the Reader (the User of your product) only sees the content via the accessibility to that content. Don't let the technology get in the way of helping your Reader.


The Bottom Line


Most literate people, with reasonable support and resources, can be guided to create effective User Documentation. A good place to find resources is listed in the "Resources" or the "About the Author" section of this article.


About the Author

Barry Millman, Ph.D., has a Bachelor of Science in Electrical Engineering and an M.Sc. and Ph.D. in Psychology. He has been a consultant for over 25 years, an instructor, course developer, and award-winning speaker. For the past seven years he has been researching and creating resources to help organizations create great User Documents.

Visit: Technical Writing Resources to Help You Create Great User Documents. for resources to help you create the User Documents that your Product needs and your Users deserve.

Visit Reading Room. for more articles like this one.



TechTotal Photo Gallery









instructional design and technical writing
instructional design and technical writing

Tuesday, 22 February 2011

Technical Writing Instructions Examples

technical writing instructions examples_2"technical writing instructions examples"
Technical document (step by step instructions, basically) ideas? (example included)?

I have to write a technical document for school. (Go to bottom for example of a technical document) Does anyone have any ideas on what to write it about? Thanks so much! ♥

Here's an example of a technical document:
How to prepare cereal:
1. Choose cereal
2. Get bowl
3. Pour cereal in bowl
4. Get milk
5. Pour milk into bowl
6. Get spoon
7. Put spoon in cereal
8. Put cereal box away
9. Put milk away
10. Enjoy cereal


OMG! I remember wrighting this! Its so wierd I really do! anyway I wrote mine on packing a lunch, it was pretty easy but apparently according to Jennifer I did it all wrong! But according to dad I did it right!! sooo yeah... whens it due? next time you come over I will show you mine! I still have it on my computer! I will show you :)


ENGLISH FOR YOU BASIC DVD 1 PART 9









technical writing instructions examples
technical writing instructions examples

Monday, 21 February 2011

Technical Writing Course Melbourne

technical writing course melbourne"technical writing course melbourne"

Remarriage is Adultery!?

Jesus said to them, "Whoever divorces his wife and marries another commits adultery against her and if she divorces her husband and marries another, she commits adultery."



Every now and then you find yourself tacking a Bible passage that just doesn't lend itself to starting your sermon with a joke. Today's Gospel reading is one such passage.



For divorce is no laughing matter, and of course I know that first-hand. Indeed, not only did I experience the divorce of my parents when I was a boy but I grew up to experience it all myself as an adult.



A wise counsellor once said to me that losing your partner is like losing a limb. Sometimes you have to lose a limb to save a body. Nonetheless, the experience is always devastating and soul-destroying and, in my experience, an inordinate amount of that devastation and soul-destruction tends to be meted out by religious people, speaking and acting on behalf of God.



In the case of my parents, I saw my mother more or less ex-communicated by her church - labelled, maligned and abandoned. And in the case of my father, who was an employee of the Diocese at the time, he lost his reputation, many of his friends, and his job.



In the breakdown of my own first marriage, thankfully I fared somewhat better than did of my parents. Even so, I lost a great number of friends - all good Christians of course - and, if you've ever wondered why, after almost 20 years in this parish I am still technically a casual so far as the Diocese is concerned, it is because I have been divorced and (worse still) have remarried!



If you work for other organisations, you might not necessarily get a lot of sympathy if your family falls apart, but you don't normally get crucified, as happens so often in the church. And in truth, the most horrible treatment I have ever seen divorced and broken people subjected to has always been at the hands of solid members of the church!



Why is it that the most judgemental, self-righteous, intolerant and unsympathetic people always seem to be church members? Well, perhaps it all starts here, in this passage in Mark 10, in the apparently inflexible, intolerant and judgemental statements of Jesus Himself - that marriage is forever and that 'whoever divorces his or her partner and marries another commits adultery against them'!



Could this really be Jesus, the friend of the weak and the marginalised? For it would appear at first glance that Jesus is far less concerned here with the weak than He is with the law - an approach that we would normally associate far more readily with Jesus' fundamentalist opponents here (the Pharisees) than would with Him!



Yet Jesus, it seems, is laying down the law, and I can almost hear the chorus of Bible-believing fundamentalists crowding in behind this passage now:



'Could Jesus have put it more plainly? Divorce is wrong. It is always wrong! Marriage is forever. There are no escape clauses, and it doesn't matter what level of immorality or abuse or mutual destruction is taking place in the family home. For indeed, the person who divorces one partner and marries another is in fact not only guilty of violating the created order of relationships but is further guilty of adultery! Why? Well, obviously because the original marriage is still valid in the eyes of God! That's why! Those whom God has joined together, let not man put asunder! Jesus has spoken!



And yet this all seems so uncharacteristic of Jesus - not only because He seems to be putting the boot in to people who are hurting, but because we are not used to seeing Jesus lay down the law in a way that puts the written code above human need.



Is there another way of understanding this dialogue? I think there is, and I think it begins with taking this dialogue in its context.



As we used to say in Bible college, 'a text without a context is a pretext for a proof-text'. In other words, you can get the Bible to say anything you like if you take isolated verses like this out of context, and the first step we need to take if we are going to take these words of Jesus seriously is to look at them in the context in which they are given, which in this case means seeing them in the context of a dialogue where Jesus' opponents are trying to trick Him.



Some Pharisees came to him and tried to trap him. "Tell us," they asked, "does our Law allow a man to divorce his wife?" (Mark 10:2)



That's how our scene opened - with the Pharisees trying to trap Jesus, and if we know the Gospels at all we know that this is not the first time. Indeed, like the wily coyote forever trying to catch the road-runner, the Pharisees were constantly trying to come up with new devices that they could use to ensnare Jesus (and like the coyote, most of their tricks blew up in their faces)!



The basic idea of their traps, at any rate, was always pretty much the same. They would try to pose a question to Jesus that He could not answer - a question that would cause Jesus trouble, whatever way He answered.



'Should we pay taxes to Caesar?' they asked, trying to trap Him. If Jesus answers 'no' to taxes, this will make him a law-breaker and a rebel in the eyes of the government, yet if He answers 'yes' and encourages the people to pay taxes to their hated Roman overlords He will make Himself unpopular.



'Should we stone this woman caught in adultery?', they ask Jesus. If He answers 'no' then He obviously doesn't take the Bible seriously because the law regarding adulteresses is written in black and white, but if He does support the woman's stoning, He will lose a lot of popular support.



Similarly here they try to trap Jesus by asking Him, "Does our law allow a man to divorce his wife?" though the trap in this case might not be as obvious to us now as it was to Jesus' first century contemporaries.



For while, on the one hand, we can appreciate that for Jesus to say 'no' to divorce would have made him seem to be at odds with the law of Moses, what we probably don't appreciate is that for Jesus to have said 'yes' to the divorce laws would have meant Him giving His support to an institution that was increasingly being used to abuse the vulnerable.




  1. In terms of the standards set by Greece and Rome, it had apparently become quite the fashion in those days to marry and divorce on a whim!

As the great Roman philosopher and statesman, Seneca, put it, "women were married to be divorced and divorced to be married". And it wasn't only the men that carried on like this. While in Rome it was customary to identify the year by the reign of the Consul, apparently amongst the fashionable women of the time it was customary to name the years after your husbands.



Of course in the Hebrew society of the time the women were far less powerful, and while it was possible for a Jewish woman to own land and to have an income, in most cases when a man divorced his wife he would completely disenfranchise her.



Women and children didn't count for much in Jesus' community, and so when a man divorced his wife he would be taking away her property, her children, her family and her community. And so it doesn't take much imagination to see how divorce could be used as a form of abuse, and how the threat of divorce could be used to intimidate an abused partner and keep her quietly subservient.



The law regarding divorce was there for a reason, as Jesus acknowledges, yet the very simplicity of the process as outlined in the Mosaic law, wherein all the divorcing partner had to do was to write a note to the woman he wanted to shed, made it highly accessible as a form of intimidation and violence.



Would we expect Jesus to support an institution of divorce that had become a tool in the hands of the powerful for the exploitation of the weak? Of course not, and so Jesus responds to the trick question of the Pharisees by reminding them that God designed men and women for relationships of mutual commitment and nurture, and not abuse. And He goes further and says that whoever uses the law to justify trading in his old wife for a new one commits adultery, regardless of whether or not he keeps to the letter of the law in the way he conducts his divorce.



Some years ago, when I was in Melbourne for the filming or a TV show, I had the privilege of meeting a rather interesting Iranian woman - a woman who had worked for some years in Tehran as a professional wife. This woman was not a sex-worker. She was a professional wife. And her clients were not sleeping around. They were having half-hour marriages.



In Tehran it is illegal for a man to sleep with a woman who is not his wife, but it is quite legal to have more than one wife. So men would come to this woman's flat and marry her. Half an hour later they would issue her a certificate of divorce and go home, back to their first wife I suppose



These guys evidently thought they were very clever for they had worked out how to keep to God's holy law and sleep with whoever they wanted to at the same time!



Their consciences were clear because they had abided by the letter of the law. They hadn't slept around. They hadn't committed adultery. They hadn't dishonoured their original wife or the other woman. They had simply exploited a loophole in the word of God by enjoying an entirely legitimate half-hour marriage. And Jesus says, "what a load of rubbish!"



Adultery is adultery, regardless of whether you have a certificate of divorce to legitimate the shedding of your old wife or a certificate of a half-hour marriage to justify taking on a new one. The laws of marriage and divorce had been put in place for a reason - to protect people and preserve the peace, but that doesn't mean you can exploit loopholes in those laws to maintain your sanctimonious moral self-righteousness while you abuse your partner.



Adultery is adultery, selfishness is selfishness and sin is sin. And while Jesus' polemic here is not really aimed at hammering sinners or even adulterers as such, He is targeting those persons who would try to justify their selfish and abusive activities through keeping them within the literal letter of the law It's all about protecting the vulnerable, and not using the letter of the law as an excuse for abuse.



Doris Mae Golberg wrote:



I have lost my husband, but I am not supposed to mourn.
I have lost my children; they don't know to whom they belong.
I have lost my relatives; they do not approve.
I have lost his relatives; they blame me.
I have lost my friends; they don't know how to act.
I feel I have lost my church; do they think I have sinned too much?
I am afraid of the future,
I am ashamed of the past,
I am confused about the present.
I am so alone,
I feel so lost.
God, please stay by me, You are all I have left.



And plenty of us have been there too, and all I really want to say here is that I believe we can be fully confident in these situations that the response of Jesus is not to put the boot in, despite the way some of His people might use passages such as today's Gospel reading to justify their judgementalism.



No. Yesterday, today, forever, Jesus is the same - the friend of the weak, the protector of the vulnerable and the advocate of the sinner. Glory to His name!


About the Author

Rev. David B. Smith

(the 'Fighting Father')

Parish priest, community worker,martial arts master, pro boxer, author, father of three

www.fatherdave.org

Fighting Father Dave

Get a free preview copy of Dave's book, Sex, the Ring & the Eucharist when you sign up for his free newsletter at www.fatherdave.org



Hazard: The Journey Of Life Trailer - March 2010









technical writing course melbourne
technical writing course melbourne

Tuesday, 8 February 2011

Writing Audit Reports

writing audit reports"writing audit reports"
Do auditors have to do a lot of writing?

Is it difficult writing? I consider difficult writing, such as writing a resume, cover letter, or school admission essay, to be just about the most grueling task imaginable. Other types of writing are very simple and require very little thought. For example, legal secretaries do a lot of writing but it is basically form letters that they do so repetitiously that it is very easy for them. My undergrad was in liberal arts so I certainly am capable of lengthy writing assignments but I always hated writing. I am now a grad student in accounting and trying to decide between audit and tax; I think I prefer audit but I am worried about the writing. I know they have to write audit reports, working papers, etc. Would this suck for someone who hates writing? Or, is it basically like writing form letters and requires very little thought? Thanks so much!!


I think I see what you mean. Writing compact bullets like a resume vs. writing in more narrative is very differernt.

I would say the writing you do in auditing is something in between.


Ryan Chittum Reports on the Rupert Murdoch Media Scandal in Britain 1 of 2









writing audit reports
writing audit reports
writing audit reports

Thursday, 30 December 2010

Technical Writing Firms

technical writing firms"technical writing firms"

Content Writing Services: Best Marketing Solution

Out in the market, companies are offering adequate business and marketing solutions, however nowadays, when vendors and shoppers are switching over to the internet, then people's predominant concern is the internet marketing solutions. Promotional and advertising strategies for the Web 2.0 are myriad and internet marketing entities do put across the same. However, if we attribute towards what experts and connoisseurs of this industry says, then they confidently advice the vendors and promoters to emphasize on the content, describing the nature, functioning and objectives of your online property.




Thus, what we ought to avail is international standard content writing services or SEO content writing solutions from a veteran and reputed firm. Here, over the internet, content is the king, and whatever optimization, promotion, advertising is being done; all is based on the content, keywords, key phrases etc. Therefore, jotting down appropriate words for the website is indispensable and in this regard, you ought to ensure that the content is created by a professional writer that retains 100% readability. Simple, straightforward, crisp and engaging content is what readers incline for, hence, it's your responsibility to explain the writer what you are looking for?




Generally, beginners and newcomers on the sphere of internet embrace a fallacy. According to them, content is only intended to fill in the websites, whereas it's untrue. Content is the quintessence of this internet world, whatever we see on the World Wide Web arena is all content. Each and every algorithm driving this virtual world considers the content available on the internet ground. And not only for the websites, but also doing optimization is impractical in the absence of content. That is why it's requisite to avail prolific website content writing services from a renowned content writing services company.




At present, if we contemplate this domain of operations, then numerous firms are catering the patrons with fruitful and quality website content writing services, apart from the general content writing solutions that includes article writing, PR creation, News writing, technical writing etc. Predominantly, these generalized written copies are being utilized in optimization and firm promotion of the online property. However, website content writing services is very formal and neat. The content remains concise and very crisp. The words and sentences ought to be structured perfectly so that they emerge formulating a perfect sentence conveying the message that is intended to be conveyed.




Although, content creators and writers are based across the planet, but still, clients are more falling for the American writers and content writing services available in the USA. Certainly, there they will hire native writers; however, it's just a misconception that only native writers are good writers. There are transforming nations like India where writers are serving overseas and domestic clientele with their unparalleled content creations services. Moreover, content writing services in USA are heavy on the wallet as compared to the services available at other nooks and corners of this planet. Thus, you ought to contemplate all the pros and cons before you eventually avail the content writing services.




 


About the Author

Red Chilli Media is a website design & development company providing complete web solutions. The Company offers various web services like ecommerce development, brochure design, internet marketing, search engine optimization, content writing services. Know more information about Red Chilli Media - An Internet Marketing Services Company.



San Diego, technical writing, writer, green tech, high tech, manual, user guide, documentation









technical writing firms
technical writing firms

Wednesday, 22 December 2010

Report Writing Findings

report writing findings"report writing findings"
when I write a report on my findings about a particulat website, do I have to cite the website throughout the?

paper or is one time at the beginning sufficient? I would technically be citing the source repeatedly because this is not common knowledge to myself or others.


Ask your teacher for his or her preference but in general if you are not sure whether to cite or not, cite it. Plagarism is nothing to fool with, might as well stay on the safe side.


We visited theTragic Cheonan Navy Ship









report writing findings
report writing findings
report writing findings

Tuesday, 5 October 2010

Technical Writing Agency

technical writing agency"technical writing agency"
I am currently working for the federal gov. I am not very interested or enthusiastic about my job. ?

I have a BS Biology. I have experience in technical writing(in a biotech environment), customer service, environmental science, education, and clerical. I also completed 12 credits of graduate environmental science courses as an admitted graduate student. Any ideas as to what federal jobs I should apply for? What agencies could they be located in? I am mostly interested in technical writing and scientific positions.


You want to work in a different area for the federal government?
No problem.
No better place to study the environment than Iraq or Afghanistan.
You could study the sand, the rocks and the dry, hot climate.
Maybe a general will need some papers filed.
Yes, I believe the Army or Marines would be a perfect fit for you.
You could sit on top of the armoured personnel carrier and tell all the other soldiers about your BS Biology and graduate courses.
You will really boost moral.
Maybe you shouldn't sit around whining about the job you have and realize you could have it much worse than you do.


Writing Lessons : How to Hire a Literary Agent









technical writing agency
technical writing agency

Thursday, 16 September 2010

Report Layout

report layout"report layout"
How much should I pay to get a 1500 sqft house appraised in Kansas city and what should I expect in the report

The house was build in 1935 and is in central Kansas City, it has a few odd things about the layout and some probloms that need to be fixed. Im looking to get the house appraised for what it is worth as it is not the median home value in the area.


size and age do not matter, appraisal should run you $300 to $400 and will be a complete report, will give 3 or 4 comparisons to homes that sold recently in the area

a home inspection is different, it would be a report on the condition of the house and have nothing to do with the price of the home they cost less $100 to $200 and would be what a potential buyer would get


FileMaker Pro 11 - Enhanced Layout/Report Assistant









report layout
report layout
report layout

Wednesday, 8 September 2010

Examples Of Technical Writing Articles

examples of technical writing articles"examples of technical writing articles"
where can i find an article on utopian societies?

I am writing a definition essay on the subject and my intentions are to have a paragraph devoted to using the technical definition to show the imposibility of it, one to using the connotation of the word to prove its communism, not utopian, and one for real life examples of people who have tried to create such a society and had it fail. I was thinking of using Hitler but he wanted a perfect race not society. Thats why i need to find a book or article preferably from a legitimate website discussing the real-life failures of the "perfect society".


http://en.wikipedia.org/wiki/Utopia or search ezinearticles.com


Real Writing Jobs Review - Scam or Real Deal?









examples of technical writing articles
examples of technical writing articles

Sunday, 5 September 2010

Technical Writing Experts

technical writing experts"technical writing experts"

Professional Writers - Custom Assignment, Project Report, Essay, Content and Technical Writing Services for college/univ students

Custom Writing Services



Professional Writers is led by a  team of writers who specialize in creating and delivering assignments  varied in  nature with an assurance of on time delivery and content free from plagiarism. Our writers are highly qualified with  many  years of experience in compiling, drafting and creating reports, articles, essays, discussion papers, thesis, dissertations, disquisitions and all other forms of writings assignments. students and professionals all over the world have welcomed and appreciated our custom writing services. we don’t just assist you in completing your assignment but, we offer a complete list of writing services to suite your project or assignment specifications.



Professional Writers is the place you can bank on because it delivers a completed assignment well within the deadline no matter what the topic may be. It  offers all  kinds of witing solutions at affordable prices. Students of UK, US, Australia, India, Scotland, Canada, Newzealand, Ireland and Germany can avail our services.



Domain Specific Writers



What makes us the most genuine organisation in this field of business is that our writers know their job and understand your specifics really well .Our team has widespread knowledge and extensive writing experience in their respective domains or fields of study. This is our win over other feature which makes us unique.



Delivery on Time




  1. Along with a free title page and bibliography  ;also two important pages and project criteria  ,Documentation writers  also assures you of on time project delivery . We have never disappointed our students and have always lived up to their expectations. However, due to any unforeseen circumstances   if  your assignment  is not delivered on time .Your money will be yours.

Affordable Pricing



Our price structure is extremely affordable. Before devising the price plan we have done an extensive survey to understand the financial state of students and about a price plan that could be the most suitable one. This whole exercise has enabled us to come up with a price plan that is acceptable to students of every level.



Satisfaction Guarantee



Students generally do not rely on others for their academic assignments because their results are  based on the score/grade awarded to them. We have researched thoroughly on students needs and requirements and are well aware of their core necessities.
From the inception of the written assignment till the final delivery time, students will be  assured that all their assignment/project requirements  shall be catered to  in all respects thereby ensuring that the objective of the assignment is met



24/7 Availability



We are available 24/7 to assist you on queries  regarding our services, to help you track the status of your assignment. Give us a call at a time suitable to you and get all your queries resolved.



Content Free of Plagiarism



 We assure you content free of Plagiarism by checking the content in Plagiarism detection softwares



Unlimited Amendments in case of discrepancies



If at any point of time, you feel that your project requirements have not been considered in totality or you wish to make amendments, but either time is inadequate or technical knowhow is beyond your reach, we will still support you and offer unlimited amendments. There will be no dip in the quality of work or approach towards the assignment. The task will be undertaken with same amount of seriousness and enthusiasm as was done at the time of initiating the project



 Citation style of your choice



Students come to us with a lot of demands and requirements.  Their requirements are adhered to in all respects. APA, MLA, Chicago, Harvard or  any other, no matter what  the citation style choice may be  you can rely on us.



Ordering Process?



Follow the instructions hereunder  to place an order for your project assignment



Step 1: Mail Us



Mail us at write@theprofessionalwriters.com Send your assignment topic,  along with its specifications, and deadline. This can be done utilizing our secure and easy-to-fill-out order form. The more clear and concise you are about your specifications the easier it is for our writer to meet your requirements.



Step 2: Quote



One of our experts will review the assignment specifications and will contact you within 24 hours with an estimated price quote. For more information on the price estimate, visit our website



Step 3: Payment



Payment to be made using  online transfer or Western Union. These details will be sent along with the mail.



 



Step 4: Confirmation



We send you a confirmation mail as a receipt of your order along with your order number and our writers immediately start working on the assignment.



Step 5: Submission



The assignment will  submitted before the dead line.



No charges will be levied for any revision work if the change requirements are related to the original documentation specifics



The document  is reviewed and proofread several times to ensure that the quality is met and adherence to the subject matter is maintained  along with other specifications laid out.



Step 6: Revisions



For any revision of the content a mail can be sent to write@theprofessionalwriters.com  stating what needs to be revised.



 Note: For new requirements there will be fresh charges .These requirements will be considered as a second part of the assignment



Professional Writers



Address



1st  Floor, Twilight Enclave



Ameerpet



Hyderabad



India



 




About the Author

writer



Mobile: +91-9989699562
write@theprofessionalwriters.com




Technical Writing Skills : How to Write a Sales Follow Up Letter









technical writing experts
technical writing experts

Monday, 9 August 2010

Report Writing Pattern

report writing pattern"report writing pattern"
What were some of the major problems during the industrial growth?

im writing a report and in one of the paragraphs im talking about the economic depressions during the industrial rev. heres what i have so far:
Industry in America, at this point in time, had a special pattern called the business cycle. In the business cycle, industries would go through good times and bad times. In 1873, there was a great economic depression that lasted for five years. This was one of the biggest depressions that there were. Another word for a depression like this was a panic. In this age, the industries would stop growing and companies would start to lose their businesses. This was called a bust in the business cycle. Workers would lose their jobs too. Slowly, things would start to pick up again and grow more. This was called a boom. The Sherman Antitrust Act made it illegal for a corporation to gain control of industries by forming trusts. Still, many of the industries in the United States grew throughout 1860 and 1900.


what else should i put?


http://answers.yahoo.com/question/index?qid=20070215150210AAjGS4f
http://answers.yahoo.com/question/index?qid=20061213153152AAU77s0


Petreaus Report is Coming Out but who is Writing it?









report writing pattern
report writing pattern
report writing pattern

Thursday, 27 May 2010

Style Guide For Technical Writing

style guide for technical writing"style guide for technical writing"

Great Technical Writing: the Two-edged Sword of Reader Experience

Overview

When we write User Documents we rely on our Reader's/User's experience to simplify our work. This can cause problems for the Reader. This article will discuss the effects of Reader experience and how to minimize the negative effects of incompatible experience, and how to handle the writer's assumptions about the Reader.

Writer's Benefits: Relying on Reader Experience

When we write, we rely on our Reader's experience to give us a "starting point" for our User Document. Often we make hidden assumptions about our Reader's experience.

Here are some examples where relying on our Reader's experience makes things easy (and causes problems) for us as writers:

Example: Using a Computer's Mouse

In writing User Documentation for Graphical User Interface-based computer products (such as the Windows or Mac User interface), we assume that the the Reader knows how to use a mouse to click on items, drag, etc. This saves much background writing.

Example: Cooking: How to Measure Ingredients; Terms

Cook books save space by (usually correctly) assuming that a Reader can perform basic cooking operations (such as measuring ingredients), and terms (such as puree or slice).

Example: Common Acronyms

We rely on "common" acronyms such as AM and PM to simplify our writing lives. However, many Readers use a 24 hour clock, and thus AM and PM are meaningless to them.

Beware of any acronyms that you assume that your Reader knows. It is best to define acronyms in line (perhaps in parentheses) when they are first presented in that part of the User Document.

You cannot define them only the first time they appear in the User Document. This assumes -- incorrectly -- that Users read your User Document from start to finish.

Problems Writers Cause When Assuming User Experience

Our assumptions as writers can get us into trouble.

Example: Unfamiliar Words

Here's a gardening example: Acme's (a fictitious company) Illustrated Guide to Gardening in Canada (1979) makes an incorrect assumption about its Readers:

In one of their definitions they use a term, "the axil of a leaf" to define another term. "Axil of a leaf" is not listed in the book's index, and there is no glossary in the book. Clearly this book assumes that the Reader understands the term "the axil of a leaf." I don't, and am therefore unhappy with the presentation.

Solution: Provide a glossary of gardening terms or a reference to a page in the book where the term is defined.

Example: Assuming Students' Experience

Here is an example where an (unstated) assumption by a training company rendered one of their courses useless.

In order to do the exercises in a computer programming course, students had to be able to use an editor (a simple word processor) to program the system. The only editor available on the course machines was a UNIX editor known as vi.

Unfortunately, the students were not told that they needed to use the vi editor. The course presenters assumed that the students knew vi. The students did not, and they spent half the course time trying to learn and deal with vi.

The hidden assumption by the training company resulted in a failed learning experience (the students never needed to use vi again). It wasted two days of the four-day course time.

Don't Present Assumptions in a Sneaky Way

If the training company had said that, "We train on UNIX systems," then they leave a way out for themselves when they disappoint students who do not know the vi editor. When confronted, the company could respond with, "We told you it was a UNIX system. You should know that vi is the editor available on that system."

This sneaky statement of the assumption is foolish. It will result in a lose-lose situation.

The Bottom Line

As writers, we to make assumptions about our Reader's experience. However, if you make assumptions, then make sure that you tell the Reader what you assume about him/her.

Think about the assumptions that you make about your Reader. Are these assumptions valid (that is, can you really expect your Readers to meet your assumptions)? If there is any doubt in your mind, include information explaining the terms and procedures that you assume.

Make sure that when you state assumptions, that you present them in a way that the Reader (student) can understand what the assumption means to them. Don't be sneaky about presenting the assumptions.

User Experience Can Cause Trouble for Writers

Your Reader's experience can cause confusion. Here are some examples:

Example: Shampoo/Conditioner Product

One of my favorite examples is a combined hair shampoo and conditioner product. If a User has experience with the separate products, then their experience is to:

* Shampoo: Wet thenhair. Massage shampoo into the hair, then rinse it out.
* Conditioner: Wash the hair. Massage conditioner into the wet hair, leave in the hair for two or three minutes, then rinse it out.

The problem arises with the combined product. Should the User leave the product in the hair for two or three minutes (as done with the conditioner), or rinse it immediately (as done with the shampoo)?

The User Document (product label) for a combined shampoo-conditioner should tell the User how to use the two-in-one product. Most such labels do not.

Example: Words Used in Unexpected Ways

Your writing can set the expectations of the Reader, resulting in confusion when words are used unexpectedly.

An article in the Technology Section (of a newspaper on June 10, 2004, page B14) described, "How the little guy can back up computer data". The article was about computers. When I came to the sentence: "Let's face it: backups are boring and a hassle to boot." I wondered about the phrase "to boot."

In computer jargon, "boot" is the process where the computer starts up ("lifts itself by its bootstraps"...by a program originally called a "bootstrap loader"). Does the author's quote about "hassle to boot" mean that if I do backups, then my computer will be slower ("boring") and require more work from me to start up ("hassle to boot")?

The use of the phrase "to boot" is inappropriate in this article, given that "to boot" has multiple meanings. The author used it as slang for "in addition to." Since the article was about computers, I thought of the computer meaning of "to boot." The sentence would be less confusing if the author left out "to boot," as: "Let's face it: backups are boring and a hassle." We'll return to this example shortly.

Example: Functional Fixedness

An object's function is fixed in a person's mind. For example, a hammer's function is to pound things. Experiments have demonstrated that people have a hard time using a hammer for an unusual function, such as a paperweight, a prop, or a lever. This is called functional fixedness.

Functional fixedness can limit the usefulness of your product. Your User Document should attempt to overcome functional fixedness. Perhaps this example will show how critical I am of User Documents.

I have a wrist global positioning satellite (GPS) device that keeps track of my long walks. Sweaters and heavy coats, needed for walking in the winter, make it difficult to wear the GPS device on the wrist. But it is a WRIST device. Functional fixedness arises, causing me struggle to use the GPS on my wrist. But it turns out that the GPS works well when used in a pocket.

The GPS User Document should mention this (obvious?) capability, thus reducing the functional fixedness associated with the WRIST GPS. In my defense: I am not sure that putting the wrist GPS in a pocket is more obvious than using a hammer as a paperweight.

Example: Humor

Humor relies on:

. a subtle knowledge of the language (for example a pun)
. or a knowledge of an event (perhaps a current event or entertainment event)

on which the humor is based. Here's an example, from an old joke:

"You're so funny, you should be on a stage. There's one leaving in 15 minutes."

This joke relies on the Reader's knowing the two meanings of "stage": (1) a place for performing, and (2) transportation used in the western United States in the 1800's. Most Readers might not know the second meaning, rendering the humor a confusing waste of words.

Earlier we examined the sentence: "Let's face it: backups are boring and a hassle to boot." The author used the phrase "to boot" as some form of folksy talk or humor. It confused the Reader.

Eliminate Humor from Your User Document

. Humor will only confuse Users who do not understand it.
. Humor is difficult, if not impossible, to translate into other languages.

I suggest that you use a writing style that is informal and conversational, but with no attempts at humor. Remove attempts at humor when you review and revise your writing.

If you want to write humor, do it elsewhere (you should be on a stage). User Documents are no place to practice your humor.

The Bottom Line

Assumptions

Be careful about what you assume about your Reader. When in doubt whether or not a Reader knows something:

. State your assumptions about your Reader
State the assumptions in a way that the Reader can relate to
. When in doubt, add the information that you assume, or
. Tell your Reader where to find the assumed information
By providing or pointing to this assumed information, you increase your audience

Readers' Experience

Be aware of how your Reader's experience influences how he/she interprets your User Document or uses your product. If necessary add material to your User Document to counter your Reader's incompatible experience.


About the Author

Barry Millman, Ph.D., has a Bachelor of Science in Electrical Engineering (1966, Carnegie Institute of Technology) and a M.Sc. and Ph.D. in Psychology (Human Information Processing, University of Calgary). He has been a consultant for over 25 years, an instructor, course developer, and award-winning speaker. For the past seven years he has been researching and creating resources to help organizations create great User Documents.

Visit: http://www.greatuserdocs.com for resources to help you create the content and access that your Users want and need.



☆ COD4 Strafe Jump Guide PS3 / Xbox 360 ☆









style guide for technical writing
style guide for technical writing

Monday, 24 May 2010

How To Write A Comprehensive Report

how to write a comprehensive report"how to write a comprehensive report"

Book Reports Projects

In book reports projects each student is required to write a book report on a book with a relevant subject matter. To begin with, book reports should not be summaries of the used books but instead an overview of the book based on significant themes or concepts which one has to talk about based on how the author brings them out. Next, each student must discuss their own point of view using valid points that are not one's own opinion. One can also add their own examples, or arguments to spice up their book reports. Book reports projects can be in the form of book report essays, book reports papers, book reports bibliographies and so on.




In order to write a book report, one should choose a book preferably the one they have a great passion about to help easily understand its principle ideas. When one chooses books that don't interest them, the results are difficulties in gaining joy from the book and a book report without certain ideas like is expected. Once the book reports' topics have been established, each one can now read their book while underlining or noting down the important points accompanied by own comments to facilitate comprehensive and quick way of obtaining the main points. Reading for book reports should be done in bits to avoid over reading. Again, the breaks should not be too long that one loses focus on what and/or where they had covered earlier on. After effectively reading the book, one can now outline the main points for their book reports.




Here, one must gather the key points that will be useful in arranging the outline. One must therefore identify issues like the setting that is, where the story takes place or how it is described, the main characters in the book, that is, identify who the story mainly talks about and how they are described, the plot, as in, one must single out the main events that make up the flow of the story, time period, that is, tell whether the story is in the present or in the past, as well as one's view by stating how the story affected them by the authors' explanations of characters, their writing style, the novel mood etc. With all these said and done, one can now write the final report by first drafting the rough draft to help gather the principle ideas and the outline for the final paper.




One important point on the draft is that it should contain all the points in the outline. After writing the final paper, one is called upon to cross check their book reports for error detection and correction. The essential building block for book reports is the plot. This provides the flow of events in the report making it easily comprehensible. One must also include conflict and other significant things that happen to the main character as they try to achieve their story goals. If a book report requires acting, one must keep it 5 to 10 minutes long, create an alternative ending for the story, and turn the report into an exemplified story and retell it using new characters. Lastly, in writing book reports, many projects may appeal but one must ensure they work well with the books one chooses.


About the Author

Author is associated with MeldaResearch.com which is a global Book Reports & Custom research Papers provider. If you would like help in Book Report and Buy essays you can visit MeldaResearch.com



160 Foot Bronze African Monument in Senegal GWETV report from West Africa









how to write a comprehensive report
how to write a comprehensive report
how to write a comprehensive report

Sunday, 9 May 2010

Technical Writing Consultants

technical writing consultants"technical writing consultants"

How To Determine The Best Roles A Consultant Can Fill

Outsourcing continues to grow in popularity as more companies deal with the pressures of competing competitively and profitably in shrinking markets.



Many companies happily include project outsourcing as part of their strategic planning while others approach the idea with fear and trepidation.



The companies who use external resources such as consultants vary in size and complexity from one-person start-up to large corporations. The one common trait they all have in common is they made the strategic decision to outsource.



Include outsourcing as part of your business strategy. Discuss your needs with a reputable consulting company and you will identify a number of key roles a qualified consultant can undertake to benefit your company. For example, consultants will:




  • Determine the scope of a project by clarifying the work to be done based on your view of the project and the outcome you expect.

  • Assist in developing the approach, determining resource requirements and preparing project timelines.

  • Use their knowledge, expertise, and past experience to identify risk and develop contingency plans.

  • Identify where internal assumptions may be inaccurate or detrimental to the success of the project.

  • Provide significant benefits by their in-depth knowledge of the marketplace, identifying your strengths and weaknesses, and recognizing potential opportunities and threats to your company.

  • Help you to critically review any internal projects which may be in progress. One major benefit is to confirm that the project team has all the tasks covered and is on the right track, or the consultant may add new information for the project team to consider.

  • Stay removed from the internal politics of the company. When assigned projects, the work is accomplished with clearly defined limits on time and budget and without the distractions of other competing projects managed by internal teams with conflicting agendas.

You may identify a number of ways where highly skilled external resources can help with the development and growth of your company. The examples above may give you fresh ideas to consider.



Whatever your needs are, you will find consultants who have the knowledge and skills to take on important roles such as:




  • Technical Consulting
  • IT Development
  • Software Development
  • Training and Development
  • Systems Analysis
  • Supply Chain Management
  • Change Management
  • Technical Writing
  • Marketing
  • Website Design
  • Business Analysis
  • Management

You may not be ready to commit to using consultants because you are still working on your business plan. Remember, strategic planning is one role where consultants can also make a valuable contribution. They have the knowledge, skills and expertise to:




  • Assess the skills and core competences of your company versus those of your competitors.

  • Provide invaluable input on trends, new opportunities or threats facing your industry.

  • Provide a different perspective on your strengths and weaknesses compared to the competition.

  • Identify where the skills and expertise within your company can be used in different ways to take advantage of new and emerging opportunities within your industry.

Some companies recognize that outsourcing can bring any number of potential benefits but they are not yet ready to include outsourcing as part of their strategic plan.



You may be unsure about outsourcing or how you would integrate external resources with your permanent staff. Discuss your concerns with a consulting company who has the knowledge and experience to demonstrate how consultants represent a cost effective way of developing and expanding the capabilities of your company without the commitment to all the associated costs of recruiting additional permanent staff.


About the Author

At ConsultantFORCE.com, companies and organizations can connect with qualified, dedicated consultants from every field and find the right consulting firm through ConsultantFORCE’s unique matching process. Personal account managers work with clients to clarify consulting project requirements and ensure that only consulting firms and/or individuals with the experience and relevant levels of expertise will be considered, providing the best possible options for success.

Please visit ConsultantFORCE.com or call 720-230-9400 for more information.



Freelance Technical Communications Consultant









technical writing consultants
technical writing consultants