1 / 17

Advanced Technical Writing 2008

Advanced Technical Writing 2008. Session #2. Web Space?. You have access to an account provided by MSU– your AFS Space . http://www.msu.edu/~your_msunet_id

uta-winters
Download Presentation

Advanced Technical Writing 2008

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript

  1. Advanced Technical Writing2008 Session #2

  2. Web Space? You have access to an account provided by MSU– your AFS Space. http://www.msu.edu/~your_msunet_id To put stuff there, FTP to ftp.msu.edu and store files in the directory called public_html; Or, in a networked lab, map the drive and navigate to your public_html directory Did that last bit of jargon confuse you?

  3. Project 1: Ergonomics Poster For the first project, we’ll be building a poster that helps folks working in Bessey 317 to work in egonomically appropriate ways. Individually, your job will be to develop content for the poster & play an editorial role in its production. You should also document your participation carefully.

  4. Project 1, Continued Information will come from… OSHA online site + MSU Ergonomic Info Center Customize the information for the specific users and specific ergonomic challenges of EBH 317 But we will… Test the poster with real users to be sure that it is a useful and usable resource We will also

  5. Project 1, Continued We will consider four key topics, each of which will be assigned to an editorial team: • Workstations (chairs, tables, computers) • Non-Workstation areas (tables, laptops) • Lighting & displays (monitors, projector, overhead lights, resolutions) • Work Processes (timing, group dynamics) We will negotiate issues of design, sequence, real estate, etc. for each of these areas on the poster.

  6. Project 1, continued In addition to reviewing key TC concepts & skills, we’ll learn other valuable things: • We’ll explore the complexities of managing multiple content-providers, including managing format & content consistency • You’ll learn important content management concepts …and there might be a few twists thrown in along the way…

  7. Project 1, Requirements • A poster, suitable for hanging up in 317, is our final deliverable; you will produce all the digital assets needed for the final production of the poster • A portfolio, compiled by each person, of work contributed to the poster project • Your portfolio will be a section of your project page that makes your contributions to the project visible

  8. Project 1, Timeline • 1/10 Choose editorial team, review information in your topic area • 1/15 Teams propose poster concepts • 1/17 Teams work out semantic markup scheme for poster content; individuals create content assets • 1/22 Teams create wireframes of posters; individuals plug assets into wireframes • 1/24 Teams create poster draft for testing • 1/31 Teams make adjustments to semantic structure; Individuals revise digital assets for poster • 2/2 Poster ready to ship to post-production shop

  9. Review: writing procedures • Parts: Title, Title Image, Byline, Introduction, Alerts, Warnings, Advance Organizers, Steps, Process Images, Outcome Images, Troubleshooting • Writing Steps: • Number the steps • Do the steps as you write them • Begin each step with a verb • Use positive commands whenever you can • Include one action per step • Group steps together in meaningful ways • Use visual cues to keep steps distinct and cue sequence • Clarify steps with visual information Dobrin, Keller, & Weisser Technical Communication in the Twenty-First Century

  10. Seeing a document as a collection of objects… Markup… All of these tags, attributes, rules, selectors, declarations…what do they mean for information designers? They are all tools you use well ONLY if you can start to see a document as a collection of objects…so, let’s practice.

  11. Workshop Time!

  12. Workshop Time! Take a look at the OSHA source material. Break it up into the objects that would be defined in a Cascading Style Sheet… Now…break it up into objects (chunks of text and or images with semantic lables) that you think are useful for the poster… Grad students…represent the whole semantic structure of one of the subgenres

  13. Objects for CSS subsection title List item in body text …and what else? Defining objects for CSS is largely a question of asking what elements on the page will need special display rules

  14. Objects for Poster Subsection theme lead image Quick Tip Defining objects for the poster is largely a question of asking what semantic elements on the page can be reused? (not a question of display…yet)

  15. Objects for Poster Subsection theme lead image Quick Tip Defining objects for the poster is largely a question of asking what semantic elements on the page can be reused? (not a question of display…yet)

  16. Semantic Structure • Title • Overview • Key Terms • Advance Organizer Section Making the semantic structure explicit involves locating all the relevant content objects, showing how they are related to one another, and noting their attributes (e.g. required or optional?)

  17. Next Time… • Editorial teams present poster concepts • Read Applen, Crowley, Geisler et. al., & Carliner (this will take you a while)

More Related