Talk:Technical Writing in the Digital Age

From LitWiki

Layout and Lead

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. —Admin (talk) 09:38, 3 October 2023 (EDT)

Citation question

I am citing a later edition of a source that is cited elsewhere on the page. (Markel, Mike, and Selber, Stuart. (2021). Technical Communication (13th ed). This version has a second author. Should these entries be combined somehow?

@Beth Kennedy: Yes. If you’re using the updated version, update the earlier source. Great question, but don’t forget to sign your talk posts. —Admin (talk) 14:35, 2 November 2023 (EDT)

Shortened Footnotes

I added the template to the project. All you need to do is add the code for your reference under Bibliography and then the SFN code under citations. I made a quick, visual step-by-step that show you how to pull the template and paste the code.--Debbiebwolfe (talk) 14:11, 11 November 2023 (EST)

References question

Should References be the heading, followed by Bibliography as a subheading? Would this only apply if we are using Notes, Citations, and a Bibliography?--CEToledo (talk) 19:14, 4 November 2023 (EDT)

@CEToledo: You can do whatever seems logical for this. Check out The Man Who Studied Yoga to see a way to approach a references section. —Admin (talk) 07:27, 6 November 2023 (EST)

--Debbiebwolfe (talk) 12:50, 6 November 2023 (EST)== Shortened footnote code == I am having trouble understanding where the placement of the works cited and the shortened footnote code should be. I sent an inquiry email to Dr. Lucas. Debbiebwolfe (talk) 14:41, 5 November 2023 (EST)

@Debbiebwolfe: I would put references at the bottom, in a bibliography section. Then you can use the shortened footnotes in the body. This is an easier approach for everyone editing, as they can easily consult the bibliography to see if a reference has been used and entered. —07:30, 6 November 2023 (EST)


Do I need to have the citation section? I see that my shorten footnotes are displaying in the reference section.--Debbiebwolfe (talk) 15:48, 6 November 2023 (EST)

Paragraph Blocks

I can't believe how well and quickly this is coming along. At any rate, on to my dispute...are we adhering to any particular standard in terms of the size of paragraph blocks? Too long and it reduces the likelihood of it being read, too brief (a single sentence) and the topic/subtopic of the contribution seems too unnecessary to even mention. -- User:CBrown

I separated the Digital Document and User Experience sections. I think paragraph blocks should have around three to four sentences max. More than that, we can create a new subheading.--Debbiebwolfe (talk) 06:41, 8 November 2023 (EST)

Topics vs. Subtopics

Why are future trends and challenges separate subtopics under the future trends and challenges topic? Should there not be an overview of future trends and challenges followed by subtopics of examples of future trends and challenges, e.g. artificial intelligence. -- User:CBrown

I am in favor of this idea/change if others agree. --Elaine Streeter (talk) 14:37, 10 November 2023 (EST)
@CBrown: The problem here is that the heading Future Trends and Challenges has room for interpretation. I think the section should just be titled Future Trends. I also think an overview of future trends could be appropriate provided information from its subheadings is not unnecessarily repeated. The material under the Challenges subheading could be relocated to another heading but I would like to hear other opinions on this proposal. —AWilliamson (talk) 20:13, 10 November 2023 (EST)
@AWilliamson: While Challenges could be a standalone heading, are we talking current or future challenges? If current, then I believe it would be best as a standalone heading. If future, then it would fit in the current format. If both, then standalone. --Mike Romano (talk) 20:04, 11 November 2023 (EST)
@Mroma98: I agree with all of your points. My interpretation of the information contained within the Challenges subheading is that it refers to current challenges. I would prefer to either get input from the individual who originally contributed the content or to obtain consensus from other editors before modifying. —AWilliamson (talk) 20:47, 11 November 2023 (EST)
@AWilliamson: OK. We're on the same page. I agree with both of your preferences.

Under Ethical Considerations, I removed the second person pronouns with a more neutral one. Though the paragraph fits with the topic, writing in the second person is not standard practice for Wikipedia/Litwiki. Litwiki is the intellectual property of Dr. Gerald R. Lucas, PhD, and the rules and format of Wikipedia apply to Litwiki. --Mike Romano (talk) 15:07, 11 November 2023 (EST)

Include external links section?

There are a few external (non-wikipedia) links in the article. Should we remove/replace the external links or create an External Links section? According to Wikipedia:External links: "With rare exceptions, external links should not be used in the body of an article. Instead, include appropriate external links in an "External links" section at the end of the article, and in the appropriate location within an infobox, if applicable." —AWilliamson (talk) 20:50, 10 November 2023 (EST)

Heading Structure

There are inconsistencies with the subheading structure on the page. I propose we establish the heading structure as follows: Heading 1 (for section titles), Subheading 1 (H2 for subsections within the main section), and Subheading 2 (H3 for items that need to be defined). No italics in subheadings.--Debbiebwolfe (talk) 14:11, 11 November 2023 (EST)

Debbie, I agree. Your suggestion makes sense, as there should be consistency throughout. --Mike Romano (talk) 19:58, 11 November 2023 (EST)
@Debbiebwolfe: I support your proposal. — AWilliamson (talk) 20:56, 11 November 2023 (EST)