diff --git a/DITA-CH.xml b/DITA-CH.xml new file mode 100644 index 0000000..ca6e37c --- /dev/null +++ b/DITA-CH.xml @@ -0,0 +1,61 @@ + + + + + + + Cathie Ryan + Chapter 4: Writing Collaboratively + Summary of Chapter 4 contents about writing collaboratively. + +

Technical writers are often employed by corporations and assigned to work on team to produce + documentation.

+

In these corporations, it is necessary for the writer to know how to collaborate with the + team.

+

When collaboration is done correctly, the documentation is better.

+

Our text book lists several advantages and disadvantages to collaboration. With + collaboration,

+

the writer can draw upon a wider knowledge and skills base. The documentation also benefits + by having

+

another person review it to make sure that it is accurate, clear, and targeted to the + intended audience.

+

Also, collaboration improves communication in the team, acclimates new writers, and improves + moral.

+

Collaboration does have disadvantages in time, interpersonal conflict, and other areas. + However, if

+

the writer conducts themselves in a professional manner, the disadvantages of collaboration + are manageable.

+

Documentation projects benefit from being planned and monitored through the process. Before + writing

+

begins, it is advisable to create a documentation plan that lists what will be written, by + whom, and

+

contain a detailed schedule with milestones such as the date when the document will be + drafted, reviewed,

+

published, and so on. Some documentation plans may include a list of risks or dependencies + that detail

+

the circumstances that impact successful completion of any and all milestones. Also, if the + documentation

+

is being written by many writers, it is best to define individual tasks for each writer and + establish a style

+

sheet, a glossary as well as the work schedules and procedures to coordinate the team’s + efforts.

+

In the career of technical writing, writers will have to attend many meetings. To be + successful,

+

the writer should be prepared for the meeting with appropriate questions, listen effectively, + and give

+

feedback. It is important to be professional and diplomatic when giving feedback.

+

Lastly, technical writers need to understand the various social media services available.

+

For example:

+ +
+
\ No newline at end of file diff --git a/DITA-CH4-reference-example.xml b/DITA-CH4-reference-example.xml new file mode 100644 index 0000000..bc86f10 --- /dev/null +++ b/DITA-CH4-reference-example.xml @@ -0,0 +1,19 @@ + + + + + + + Glossary of Terms + From Technical Communication by Mike Markel. + +
+ Audience Profile Sheet +

A document that records characteristics of the audience. For example, the audience profile + sheet could include education level, job responsibilites, type of work environment, cultural + characteristics and many more.

+
+
+
diff --git a/DITA-CH4-task-example.xml b/DITA-CH4-task-example.xml new file mode 100644 index 0000000..1372803 --- /dev/null +++ b/DITA-CH4-task-example.xml @@ -0,0 +1,35 @@ + + + + + + Writing Process + From Technical Communication by Mike Markel. + + +

Typical steps when writing technical documentation.

+
+ + + Planning + + + Drafting. + + + Revising. + + + Editing. + + + Proofreading. + + +
+
\ No newline at end of file diff --git a/DITA-CH4.xml b/DITA-CH4.xml new file mode 100644 index 0000000..ca6e37c --- /dev/null +++ b/DITA-CH4.xml @@ -0,0 +1,61 @@ + + + + + + + Cathie Ryan + Chapter 4: Writing Collaboratively + Summary of Chapter 4 contents about writing collaboratively. + +

Technical writers are often employed by corporations and assigned to work on team to produce + documentation.

+

In these corporations, it is necessary for the writer to know how to collaborate with the + team.

+

When collaboration is done correctly, the documentation is better.

+

Our text book lists several advantages and disadvantages to collaboration. With + collaboration,

+

the writer can draw upon a wider knowledge and skills base. The documentation also benefits + by having

+

another person review it to make sure that it is accurate, clear, and targeted to the + intended audience.

+

Also, collaboration improves communication in the team, acclimates new writers, and improves + moral.

+

Collaboration does have disadvantages in time, interpersonal conflict, and other areas. + However, if

+

the writer conducts themselves in a professional manner, the disadvantages of collaboration + are manageable.

+

Documentation projects benefit from being planned and monitored through the process. Before + writing

+

begins, it is advisable to create a documentation plan that lists what will be written, by + whom, and

+

contain a detailed schedule with milestones such as the date when the document will be + drafted, reviewed,

+

published, and so on. Some documentation plans may include a list of risks or dependencies + that detail

+

the circumstances that impact successful completion of any and all milestones. Also, if the + documentation

+

is being written by many writers, it is best to define individual tasks for each writer and + establish a style

+

sheet, a glossary as well as the work schedules and procedures to coordinate the team’s + efforts.

+

In the career of technical writing, writers will have to attend many meetings. To be + successful,

+

the writer should be prepared for the meeting with appropriate questions, listen effectively, + and give

+

feedback. It is important to be professional and diplomatic when giving feedback.

+

Lastly, technical writers need to understand the various social media services available.

+

For example:

+ +
+
\ No newline at end of file diff --git a/DITA-CH6.xml b/DITA-CH6.xml new file mode 100644 index 0000000..8fbaa81 --- /dev/null +++ b/DITA-CH6.xml @@ -0,0 +1,64 @@ + + + + + + + Cathie Ryan + Chapter 6: Researching Your Subject + Summary from Technical Communication by Mike Markel. + +

The main purpose of searching a subject is to get answers to questions. You may need an + answer to a

+

practical question such as “Should tablets replace notebooks in the workplace?”. + Alternatively, you may

+

need to answer scholarly questions. Whether you are searching for answers to practical + questions or

+

scholarly questions, your research will fall into two main types:

+ +

Good research is planned. The audience, purpose, and subject need to be analyzed to narrow + down the

+

scope of the project. Budgets, time schedules and the form of the final documentation need to + be worked out.

+

You will essential to determine how much to research, how much research will actually be + summarized in the

+

document, and how much research is needed to provide you with enough background knowledge + that you can

+

understand and write to your audience.

+

Before you start researching, it is helpful to write out the questions that you need to + answer.

+

Then you will need to be persistent to find the answers to your questions. You will want to + have a system

+

for recording or managing the information that you find. Finally, you will want to make sure + that you have

+

triangulated the information. That means that you found 3 different sources that answer the + question in

+

three different ways.

+

You can find information in traditional form, online social media, or forms that you + generate yourself:

+ +
+
\ No newline at end of file diff --git a/DITA-CH9.xml b/DITA-CH9.xml new file mode 100644 index 0000000..afe38d1 --- /dev/null +++ b/DITA-CH9.xml @@ -0,0 +1,34 @@ + + + + + + + Cathie Ryan + Chapter 9: Emphasizing Important Information + Summary from Technical Communication by Mike Markel. + +

This chapter taught us about how to write so that important information is easily accessible + and understood. Here are some important points:

+ +
+
\ No newline at end of file diff --git a/DITA_MAP b/DITA_MAP new file mode 100644 index 0000000..a07b6df --- /dev/null +++ b/DITA_MAP @@ -0,0 +1,8 @@ + + + + + + + + diff --git a/concept-example.xml b/concept-example.xml index eb78822..8b9e726 100644 --- a/concept-example.xml +++ b/concept-example.xml @@ -9,11 +9,14 @@ 'dtd1.2/technicalContent/dtd/concept.dtd'> - Your name - My Abstract - My Abstract + Cathie Ryan + JavaScript + Programming language that turns your webpages into a program. test -

First paragraph

-

Second paragraph

+

JavaScript is a programming language that you use with your webpages to turn webpages into a + program. It allows the developer to gather input and manipulate the webpage after the webpage + has been loaded.

+

Javascript is deeply embedded with the browser. It uses an event driven model which means + that the event is not run until the event is triggered.

\ No newline at end of file diff --git a/reference-example.xml b/reference-example.xml index cd7bbaa..04d02f8 100644 --- a/reference-example.xml +++ b/reference-example.xml @@ -6,26 +6,22 @@ - Other error messages - In addition to error messages generated by the DITA Open Toolkit, you might also encounter error messages - generated by Java or other tools. + JavaScript Events + Triggers the execution of the event that affect the webpage. test
Out of Memory error

In some cases, you might receive a message stating the build has failed due to an Out of Memory error. Try the following approaches to resolve the problem:

    -
  1. Increase the memory available to Java.
  2. -
  3. Reduce memory consumption by setting the option to - false. This option is set in the lib/configuration.properties file. - This will disable debug attribute generation (used to trace DITA-OT error messages back to source files) and - will reduce memory consumption.
  4. -
  5. Set dita.preprocess.reloadstylesheet Ant property to true. This will allow - the XSLT processor to release memory when converting multiple files.
  6. -
  7. Run the transformation again.
  8. +
  9. Loading the webpage.
  10. +
  11. Leaving the webpage.
  12. +
  13. Clicking a link.
  14. +
  15. Scrolling up or down.
+ Specific JavaScript Error List java.io.IOException: Can't store Document

After running a JavaHelp transformation, you may receive a java.io.IOException: Can't store Document message.

diff --git a/task-example.xml b/task-example.xml index cb42bf3..45de8bc 100644 --- a/task-example.xml +++ b/task-example.xml @@ -8,33 +8,33 @@ - Changing the oil in your car - Once every 6000 kilometers or three months, change the oil in -your car. + JavaScript and Chrome Development Tools + Viewing the Chrone Development console. test -

Changing the oil regularly -will help keep the engine in good condition.

+

Use the Chrome Development console to debug errors that can occur when JavaScript is run.

- To change the oil: + To view the console: - Remove the old oil filter. + Open the Developer Tools and click the Console Tab. - Drain the old oil. + At the > prompt, enter the JavaScript code to be evaluated. - Install a new oil filter and gasket. + If the JavaScript code evaluates correctly, you can enter this code into your + script. - Add new oil to the engine. + If the JavaScript code does not evaluate correctly, determine what is causing the + error. The error could be caused by a typo or misuse of a command. - Check the air filter and replace or clean it. + Once you have determined the cause of the error, return to step 2. - Top up the windshield washer fluid. + Continue to debug all errors until there are not any left to debug.