Talk:Technical Writing in the Digital Age: Difference between revisions

m (→‎Images: Replying to inquiry about adding images)
 
(22 intermediate revisions by 5 users not shown)
Line 2: Line 2:
Just to get this thing going, I have created the article, developed a rudimentary layout, and added a lead written by ChatGTP. '''All of this may be kept or changed'''. I would certainly revise or rewrite the lead. Questions, ideas, discussion, and comments about the project should be posted here. I'm looking forward to seeing what you all come up with this semester. —[[User:Admin|Admin]] ([[User talk:Admin|talk]]) 09:38, 3 October 2023 (EDT)
Just to get this thing going, I have created the article, developed a rudimentary layout, and added a lead written by ChatGTP. '''All of this may be kept or changed'''. I would certainly revise or rewrite the lead. Questions, ideas, discussion, and comments about the project should be posted here. I'm looking forward to seeing what you all come up with this semester. —[[User:Admin|Admin]] ([[User talk:Admin|talk]]) 09:38, 3 October 2023 (EDT)
:If no one else is going to address the lead being written by ChatGPT, I'm going to go ahead and jump in and make revisions.--[[User:Valerie Emerick|Valerie Emerick]] ([[User talk:Valerie Emerick|talk]]) 07:15, 28 November 2023 (EST)
:If no one else is going to address the lead being written by ChatGPT, I'm going to go ahead and jump in and make revisions.--[[User:Valerie Emerick|Valerie Emerick]] ([[User talk:Valerie Emerick|talk]]) 07:15, 28 November 2023 (EST)
::The revised introduction looks great, Valerie! The only thing that I would suggest potentially changing is in the last sentence. I believe "our" or any first or second person pronouns is not aligned with Wikipedia's/Litwiki's neutral point of view. I could be wrong, though. Other than that, I love the new intro! --[[User:Mroma98|Mike Romano]] ([[User talk:Mroma98|talk]]) 21:07, 30 November 2023 (EST)


==Citation question==
==Citation question==
Line 9: Line 10:
::{{Reply to|Admin}}Thank you. I have linked the first citation in the article (paragraph 1) to my Markel use under "Rhetorical Strategies." {{Reply to|mroma98}} and {{Reply to|RDrummond}}, in looking at the article history, it seems one of you may have added the Markel references under Ethical Considerations. I did not update those references yet because the oldest copyright date on my source is 2012, and I was also unsure of the page numbers. If you review the citation I added, and it is appropriate to reference, the shortened reference is <ref name="Markel">. Thanks. --[[User:Beth Kennedy|Beth Kennedy]] ([[User talk:Beth Kennedy|talk]]) 18:23, 13 November 2023 (EST)
::{{Reply to|Admin}}Thank you. I have linked the first citation in the article (paragraph 1) to my Markel use under "Rhetorical Strategies." {{Reply to|mroma98}} and {{Reply to|RDrummond}}, in looking at the article history, it seems one of you may have added the Markel references under Ethical Considerations. I did not update those references yet because the oldest copyright date on my source is 2012, and I was also unsure of the page numbers. If you review the citation I added, and it is appropriate to reference, the shortened reference is <ref name="Markel">. Thanks. --[[User:Beth Kennedy|Beth Kennedy]] ([[User talk:Beth Kennedy|talk]]) 18:23, 13 November 2023 (EST)
:::{{Reply to|Beth Kennedy}} Thank you, Beth. I contributed to the Ethical Considerations section. My Markel source was from 2009, but the same information appears in later editions, so the 2012 reference should work, too. --[[User:Mroma98|Mike Romano]] ([[User talk:Mroma98|talk]]) 16:26, 25 November 2023 (EST)
:::{{Reply to|Beth Kennedy}} Thank you, Beth. I contributed to the Ethical Considerations section. My Markel source was from 2009, but the same information appears in later editions, so the 2012 reference should work, too. --[[User:Mroma98|Mike Romano]] ([[User talk:Mroma98|talk]]) 16:26, 25 November 2023 (EST)
::::{{Reply to|mroma98}}Thanks for replying. I found your information in the newer version and moved your citations so we can all use the same Markel source.--[[User:Beth Kennedy|Beth Kennedy]] ([[User talk:Beth Kennedy|talk]]) 17:33, 30 November 2023 (EST)
:::::{{Reply to|Beth Kennedy}} Thank you for that, Beth. Looks great! It definitely flows better and more sensibly to have the same edition from Mr. Markel throughout the article. --[[User:Mroma98|Mike Romano]] ([[User talk:Mroma98|talk]]) 21:10, 30 November 2023 (EST)


==Shortened Footnotes==
==Shortened Footnotes==
Line 42: Line 45:


Just wanted to let everyone know to check to see if the reference you're using is already listed in the bibliography section. If it is, then just add the shortened footnote in the content. If it's not, then add the reference in the bibliography as well as the sfn in the content. Adding duplicate references in the bibliography cause errors to happen in the citations.--[[User:Natecole54|Natecole54]] ([[User talk:Natecole54|talk]]) 15:18, 27 November 2023 (EST)
Just wanted to let everyone know to check to see if the reference you're using is already listed in the bibliography section. If it is, then just add the shortened footnote in the content. If it's not, then add the reference in the bibliography as well as the sfn in the content. Adding duplicate references in the bibliography cause errors to happen in the citations.--[[User:Natecole54|Natecole54]] ([[User talk:Natecole54|talk]]) 15:18, 27 November 2023 (EST)
:Thank you for taking on that task, Nate! It appears to have turned out nicely. --[[User:Mroma98|Mike Romano]] ([[User talk:Mroma98|talk]]) 21:13, 30 November 2023 (EST)


== Paragraph Blocks ==
== Paragraph Blocks ==
Line 215: Line 219:
:{{Reply to|Emmakd}} I don't mind the structure being condensed into 6 sections instead of 13. Just be mindful of the citation template code in the body that supports the shortened footnote code. --[[User:Debbiebwolfe|Debbiebwolfe]] ([[User talk:Debbiebwolfe|talk]]) 05:48, 29 November 2023 (EST)
:{{Reply to|Emmakd}} I don't mind the structure being condensed into 6 sections instead of 13. Just be mindful of the citation template code in the body that supports the shortened footnote code. --[[User:Debbiebwolfe|Debbiebwolfe]] ([[User talk:Debbiebwolfe|talk]]) 05:48, 29 November 2023 (EST)


*Overview
I went ahead and reorganized the sections. It was mostly just moving the several sections about digital writing into subsections underneath a single "Strategies for Digital Writing" section. I think this has messed with the formatting of some of the subheadings, I'll try to go back through and make sure everything is uniform, but it seems there are multiple people editing right now, so I'll wait until later as to not interfere. --Emma D. 18:55, 29 November 2023 (EST)
**Goal of Technical Communication
**Characteristics of Technical Communication
*History
**Technical Writing Profession
**Future Trends
*Technical Communication Strategies
**Characteristics of Technical Communication
***Standards Compliant
***Detail Oriented
***Objective
***Clear and Concise
***Formatted and Organized
***Graphical
***Audience Specific
***Document Design
**Examples of Technical Documents
***Case Studies
***Data Sheets
***Descriptions
***Documentation
***Email
***Letters
***Memos
***Press Releases
***Proposals
***Reports
****Informal or Brief Reports
****Formal Reports
***Resumes
***User Guides
*Digital Writing Strategies
**Characteristics of Digital Documents
***Electronic Format
***Non-Tangible
***Accessibility
***Readability
***Scannability
***Ease of Reproduction and Distribution
***Hyperlinking
***Multimedia
***Version Control
***Remote Collaboration
***Security Measures
***Environmental Impact
***Dynamic Updates
***Global Accessibility
***Data Integration
***Data Analytics
**Examples of Digital Documents
***Infographics
***Presentations
***Blogs
**Personas in Digital Writing
**Rhetoric
**Search Engine Optimization (SEO)
***Keywords
***Alt Text
***Social Media Presence
***Goals of Searching: User Perspective
**Digital Tools
***Content Management Systems (CMS)
***Image Processing Software
***Word Processors
***Text Editors
**User Experience
***User-Centered Design
***Information Architecture
***Responsive Design
***Usability
*Pedagogical Approaches
**Writing Styles
**Multimedia Writing
**Breaking and Building
*Challenges and Ethical Considerations
**Challenges
**Artificial Intelligence
**Plagiarism
**Ethical Considerations
***The Employer
***The Public
***The Environment
***Disinformation
*References


== Late to the party ==
== Late to the party ==
Line 314: Line 235:
Hey everyone! I was looking over the page and realized that the article is very long with no pictures or examples. If it pleases the group, I can go through and add pictorial examples from our textbooks and readings to go along with what we are talking about in certain sections and then add the ref to it? [[User:Ebyington3|Ebyington3]] ([[User talk:Ebyington3|talk]]) 06:42, 29 November 2023 (EST)
Hey everyone! I was looking over the page and realized that the article is very long with no pictures or examples. If it pleases the group, I can go through and add pictorial examples from our textbooks and readings to go along with what we are talking about in certain sections and then add the ref to it? [[User:Ebyington3|Ebyington3]] ([[User talk:Ebyington3|talk]]) 06:42, 29 November 2023 (EST)


:{{Reply to|Ebyington3}} That is a wonderful idea. [[User:APitts]]
:{{Reply to|Ebyington3}} That is a wonderful idea. --[[User:APitts]]
 
:{{Reply to|Elbyington3}} Please let me know if you need anything help with adding picture. I'm going through and expanding as needed on subjects and organization. --[[User:JCaruso]] ([[User talk:JCaruso|talk]]) 09:39, 29 November 2023 (EST)
 
== Multimodality ==
 
I know this topic is covered under the characteristics topic; however, I feel like this is essential to user experience as well. Unless I'm missing something, I plan to add and expand this approach/theory under user-experience referring to our texts as well and examples, etc.
 
Please let me know if you disagree or think this is a bad idea. --[[User:JCaruso]] ([[User talk:JCaruso|talk]]) 10:30, 29 November 2023 (EST)
 
== Subheading formatting ==
 
Hi all, I know someone worked hard on adding bold formatting to the sub-subheadings, but it wasn't applied to all of them (or new content was added without it since then). I personally think bolding them makes them harder to distinguish from the headings at the next level up. The sub-subheadings are in a different font and the spacing separates them from the body text, so I removed the bold. I think it's much more scannable this way. --Emma D. 23:55, 30 November 2023 (EST)
32

edits