Category: Technical Communication

  • Reflections on a Month of LinkedIn Learning

    Photo of a business cat taking notes in his office. Image created with Stable Diffusion.
    Photo of a business cat taking notes in his office. Image created with Stable Diffusion.

    As I wrote at the beginning of July here, I planned to take advantage of LinkedIn Learning’s free one-month trial. I wanted to report back on my experience of taking LinkedIn Learning courses and provide more details about some of my tips that might help you be more successful with LinkedIn Learning.

    Breakdown of the Courses and Learning Paths

    LibreOffice Calc spreadsheet showing Jason's LinkedIn courses and time totals.

    I created the spreadsheet above in LibreOffice Calc as a list of all of the courses I had completed between June 29 and August 3 (I’m including the end of June courses in the free Career Essentials in Generative AI by Microsoft and LinkedIn that gave me the idea to continue with the free one month trial period). I included the instruction time for each course. This allowed me to calculate that I had completed 43 hours 11 minutes of course instruction across 39 courses during my LinkedIn Learning trial period.

    I regret not keeping track of how long I spent on each course, which was far longer due to pausing the video to write notes, studying notes, taking quizzes, writing assignments, and taking exams. I believe the 50% extra time per course that I wrote about in July holds true.

    I focused on two main areas: Generative AI, which I am building into my workflows and maintaining a pedagogical bibliography for here; and Diversity, Equity, and Inclusion (DEI) Communication Best Practices, which I wanted to use to improve my teaching practices by structuring my classroom as supportive and welcoming to all students.

    In the Generative AI courses, I learned about machine learning, different forms of generative AI, how generative AI is integrated (or being integrated) into local and server software, and frameworks for critique of AI systems in terms of ethics, bias, and legality. Also, I took some courses on Python to get an inkling of the code underpinning many AI initiatives today.

    In the DEI Communication Best Practices cluster of courses, I learned helpful terminology, techniques for engagement, what to do to support and include others, and how to be an ally (mostly with an emphasis on the workplace, but thinking about how to leverage these lessons in the classroom). These courses covered combating discrimination, planning accessibility from the beginning and benefit of all, and supporting neurodivergence.

    Overall, each learning experience was beneficial to my understanding of the topic. However, some instructors delivered better courses–for my way of learning–by employing repetition, anchoring key topics with words and definitions on the video (which you can pause and write down), giving more quizzes over shorter amounts of material (instead of fewer quizzes over longer time spans of material), and giving students mini projects or assignments to reinforce the lesson (e..g, pause and write about this, or pause the video, solve this problem, and “report back”–the course isn’t interactive but the “report back” idea is to compare your solution to the instructor’s after the video is played again).

    All of the courses provide a lot of information in a very short amount of time. In some cases, the information compression is Latvian repack level. Even taking notes in shorthand, I could not keep up in some instances. To capture all of the information, I had to pause videos repeatedly, repeat (using the 10 second reply often) and read the transcript.

    While I enjoyed the standalone courses, the Learning Paths provided a sequence and overlap in material that helped reinforce what was being taught. Also, Learning Paths helped me see connections between the broader implications of the topic (e.g., DEI, accessibility, neurodiversity, etc.) as well as explore certain aspects of the topic in more depth (e.g., how to approach conversations on uncomfortable topics or how to ask for permission to be an ally in a given situation).

    Each instructor has a unique way of speaking and engaging the learner. I really enjoyed the diversity of the instructors across all topics.

    The accessibility features built into LinkedIn Learning helped me follow along and make accurate notes. In particular, I always turned on closed captioning and clicked the “Transcript” tab beneath the video so that I could easily follow along and pause the video when there was a keyword or definition or illustration that I wanted to capture in my notes.

    LibreOffice Calc chart showing how many hours of courses were completed on the days between 6/29 and 8/3/2023.

    I added the course instruction time for those courses completed on the same day to generate the chart above that illustrates the ebb and flow of my course completion across the month. In some cases, I spread out the instruction across days to give myself enough time to learn and practice the topics being discussed (e.g., Python programming or Stable Diffusion image generation). There were other days that I paused my learning to work on my research or simply to take a break from learning.

    On LinkedIn Learning, some of the courses are grouped together into what are called Learning Paths, which yield a separate certificate of completion from the certificates that you earn for each individual course. In some cases, as in the Career Essentials in Generative AI by Microsoft and LinkedIn also includes an exam with a time limit (1.5 hours) that must be passed before the Learning Path certificate is given. About 50% or 21 hours 45 minutes of the 43 hour 11 minute course instruction time applied to five earned Learning Paths for me:

    • Career Essentials in Generative AI by Microsoft and LinkedIn, 3h 49m
    • Accessibility and Inclusion Advocates, 3h 18m
    • Diversity, Inclusion, and Belonging for All, 6h 16m
    • Responsible AI Foundations, 4h 15m
    • LinkedIn’s AI Academy, 3h 54m

    LinkedIn Learning Success Tips

    Overall, I want to reiterate the tips that I wrote about here for being successful at LinkedIn Learning–both in terms of how you learn and how you demonstrate what you have learned. Below are some reiterated tips with details based on my experience this past month.

    Be an Active Learner: Take Notes, Do the Exercises, and Complete the Quizzes

    Fanned out loose-leaf notes that Jason took during his LinkedIn Courses.

    The one thing that I would like to stress above all others is how important it is to treat a LinkedIn Learning course like a classroom learning experience. What I mean by that is that you need to set aside quality time for learning, free from distraction, where you can take notes and complete the exercises, and study what you’ve learned before taking quizzes or exams. Employing your undivided attention, writing your notes by hand in a notebook, and completing quizzes, exams, and assignments all contribute to your learning, integrating what you’ve learned with your other knowledge, and preparing yourself to recall and apply what you’ve learned in other contexts, such as in a class or the workplace.

    Unless you have eidetic memory, the fact is that you won’t learn a lot by passively watching or listening to courses. And even if you have photographic memory, all you will gain are facts and not the integration, connections, and recall that comes from using and reflecting on what you have learned.

    Remember to Add Certifications to Your LinkedIn Profile

    Jason Ellis's Licenses & Certifications section on his LinkedIn Profile.

    Remember to add each completed LinkedIn Course and Learning Path certification to your profile. They will appear in their own section as they do on mine shown above.

    Completed Courses and Learning Paths do not automatically appear on your profile (consider: someone might not want all of their training to appear on their LinkedIn Profile for a variety of reasons).

    To add a Course or Learning Path to your LinkedIn Profile, go to LinkedIn Learning > click “My Learning” in the upper right corner > click “Learning History” under “My Library” on the left > click the “. . .” to the right of the Course or Learning Path > click “Add to Profile” and follow the prompts.

    LinkedIn also gives you the option to create post on your Profile about your accomplishment, which you should opt to do. When you do this, it auto suggests skills that it will add to your Skills section of your Profile. You can have up to 50 skills on your profile, so keep track of what’s there and prune/edit the list as needed to highlight your capabilities for the kinds of jobs that you are looking for. More on Skills further down the page.

    Add Certifications to Your Resume or CV

    Excerpt image of Jason Ellis' CV. Link to CV below.

    As shown above and viewable on my CV here, I added links to my LinkedIn Course and Learning Path certifications in a dedicated section of my CV. In addition to the unique link to my certifications, I included the organization that issued it (i.e., LinkedIn), and the date of completion. You can do the same on your CV or resume.

    To get the link to a Course or Learning Path completion certificate, go to LinkedIn Learning > click “My Learning” in the upper right corner > click “Learning History” under “My Library” on the left > click the “. . .” to the right of the Course or Learning Path > click “Download certificate” > click “LinkedIn Learning Certificate” > toggle “On” under the top section titled “Create certificate link” > Click “Copy” on the far right.

    While you are here, you can download a PDF of your certificate for safe keeping at the bottom left of this last screen. You can add these PDFs to a professional portfolio or alongside a deliverable that you create based on the skills that you gained from that course to demonstrate your learning and mastery.

    Demonstrate Your Skills

    Jason Ellis' Skills section on his LinkedIn Profile.

    As I mentioned above, when you post about completing a course, LinkedIn Learning can autogenerate relevant skill terms to add to the Skills section on your Profile (as shown above on my Profile). When you have the spare time and focus, you should occasionally click on “Demonstrate skills” (you can do this without a LinkedIn Learning subscription). This gives you options for taking exams related to different skills that you’ve added to your Skills section of your Profile. If you pass, it provides some proof that you know something about that particular skill. Beware though: these exams can be tough. When I took the HTML exam, I discovered big gaps in what I knew from learning HTML years before without keeping up with changes to HTML in the intervening years. While I passed the exam, I made notes about those questions that I got wrong so that I knew what to learn more about to fill in those gaps.

    Also, some skills don’t have exams associated with them. In those cases, you may submit a video or essay to demonstrate your experience to potential recruiters or hiring managers. If you do this, you should plan it out, shoot and edit your video to give the best visual and auditory impression, or write and revise your essay so that it is of the highest professional quality.

    Is It Worth It?

    Looking back on what I learned, how I learned it, and who I learned it from, I’m glad that I invested the time and energy into a month of LinkedIn Learning. I’ve already started putting some of the lessons into practice (e.g., the generative AI and ethical AI courses), and I’m planning out how I will roll out the DEI approaches in my courses when I return to teaching in Fall 2024 (I am on sabbatical this academic year). In the future, I plan to pay for LinkedIn Learning when additional classes are available and I have the time to immerse myself in learning.

    If you’re looking to skill up, I think that LinkedIn Learning can be beneficial if you go into it with a learning and reflective mindset. This means that you are willing to invest your attention, time, energy, and thought to learning the course material, want to reflect on how what you learn connects to other things you’ve already learned through school and work experience, apply what you’ve learned to deliverables that demonstrate you have integrated what you have learned (e.g., a detailed post on your LinkedIn Profile, a blog post, a poster, a video, an addition to your professional portfolio, etc.), and reflect, preferably in writing, on what you’ve learned, how you applied it, what you would like to see yourself accomplish next, and how to take those next steps.

    As I said above, you likely won’t gain much by passively listening to LinkedIn Learning Courses while doing other things or being distracted by your environment. Invest in this form of learning and you will add to what you know and can do. In that spirit, it’s like my Grandpa Ellis used to tell me, “Jake, no one can take away your education!”

  • Summer Studying with LinkedIn Learning

    An anthropomorphic cat taking notes in a lecture hall. Image created with Stable Diffusion.

    I tell my students that I don’t ask them to do anything that I haven’t done or will do myself. A case in point is using the summer months for a learning boost. LinkedIn Learning offers new users a free trial month, which I’m taking advantage of right now.

    While I’ve recommended students to use LinkedIn Learning for free via the NYPL, completion certificates for courses don’t include your name and they can only be downloaded as PDFs, meaning you can’t easily link course completion to your LinkedIn Profile. Due to the constraints with how library patron access to LinkedIn Learning works, I opted to try out the paid subscription so that it links to my LinkedIn Profile. However, I wouldn’t let these limitations hold you back from using LinkedIn Learning via the NYPL if that is the best option for you–just be aware that you need to download your certificates and plan how to record your efforts on your LinkedIn Profile, your resume, and professional portfolio.

    After a week of studying, I’ve earned certificates for completing Introduction to Responsible AI Algorithm Design, Introduction to Prompt Engineering for Generative AI, AI Accountability Essential Training. And, I passed the exam for the Career Essentials in Generative AI by Microsoft and LinkedIn Learning Path. I am currently working on the Responsible AI Foundations Learning Path. These courses support the experimentation that I am conducting with generative AI (I will write more about this soon), the research that I am doing into using AI pedagogically and documenting on my generative AI bibliography, and thinking how to use AI as a pedagogical tool in a responsible manner.

    For those new to online learning, I would make the following recommendations for learning success:

    1. Simulate a classroom environment for your learning. This means find a quiet space to watch the lectures while you are watching them. Don’t listen to music. Turn off your phone’s notifications. LinkedIn courses are densely packed with tons of information. Getting distracted for a second can mean you miss out on something vital to the overall lesson.
    2. Have a notebook and pen to take notes. While watching the course, pause it to write down keywords, sketch charts, and commit other important information to your notes. The act of writing notes by hand has been shown to improve your memory and recall of learned information. Don’t keep notes by typing as this is less information rich learning than writing your notes by hand.
    3. Even though a course lists X hours and minutes to completion, you should budget at least 50% more time in addition to that time for note taking, studying, quizzes, and exams (for those courses that have them).
    4. While not all courses require you to complete quizzes and exams for a completion certificate, you should still take all of the included quizzes and exams. Research shows that challenging ourselves to recall and apply what we’ve learned via a test helps us remember that information better.
    5. After completing a course, you should add the course certificate to your LinkedIn Profile, post about completing the course (others will give you encouragement and your success might encourage others to learn from the same course that you just completed), add the course certificate to your resume, and think about how you can apply what you’ve learned to further integrate your learning into your professional identity. On this last point, you want to apply what you’ve learned in order to demonstrate your mastery over the material as well as to fully integrate what you’ve learned into your mind and professional practices. This also serves to show others–managers, colleagues, and hiring personnel–that you know the material and can use it to solve problems. For example, you might write a blog post that connects what you’ve learned to other things that you know, or you might revise a project in your portfolio based on what you’ve learned.
    6. Bring what you’ve learned into your classes (if you’re still working toward your degree) and your professional work (part-time job, internship, full-time job, etc.). Learning matters most when you can use what you’ve learned to make things, solve problems, fulfill professional responsibilities, and help others.
  • Customize Xfce on Debian 12 Bookworm to Look Like BeOS and Haiku OS

    BeOS desktop image

    This weekend, I installed Debian 12 Bookworm with Xfce desktop environment on my desktop computer, because I wanted a pure Xfce installation on top of a distro running a 6.0 or higher kernel to theme as close to BeOS as I can get.

    As I’ve written about before here, I have fond memories of using BeOS on my old PowerMacintosh 8500/120. When I used it on that hardware, it felt like the future. Many of its features were ahead of its time for a desktop computing environment. It was also incredibly easy to navigate and interact with due to its colors, icons, and textured UI elements.

    I believe that BeOS and Haiku OS have GUIs that are easy to see and interact with, because they aren’t flattened to death like most contemporary operating systems, which have less contrast and textured borders that hinder visual comprehension and interaction.

    I tried installing Xubuntu, but after installation, I was greeted by the login prompt, I entered my credentials, received a black screen (NB: not rebooting–for some reason the DE wouldn’t launch and it would kick me back to the login screen), and was greeted again by the login prompt. Since that was a fresh installation, I was concerned about the long-term stability of it on my computer. Hence, I tried out Debian 12, which installed and booted without a hitch!

    In addition to reinstalling Automatic1111 for Stable Diffusion for AI image generation and Llama.cpp for AI text generation, I set about theming Xfce to look as much like BeOS as possible.

    I describe step-by-step how to make Xfce mimic BeOS in the sections below.

    Window Manager Theme

    Window Manager window

    Perhaps the most notable aspect of BeOS/Haiku’s look-and-feel is the yellow, tabbed window title bar. Some tutorials suggest using the BeOS-r5-XFWM theme, but I opted for the Haiku-Alpha theme, because it only keeps the close window tic box and eliminates the other options such as minimize, maximize, etc., which you can still operate by setting one option to title bar double clicks and others from the drop-down right-click menu.

    Decompress the downloaded file and move the resulting folder into ~/.themes (remember to turn on “show hidden files and folders” in your file manager, and create the .themes folder if it does not already exist). Then, go to Settings > Window Manager > select Haiku-Alpha. Also, set the font to Swis721 BT Bold size 9 (see font section below for more info).

    Appearance Theme

    Appearance window

    To give Xfce the general look-and-feel of BeOS’s relatively high contrast interface (by today’s modern, flat interface standards), I installed the BeOS-r5-GTK theme.

    Decompress the downloaded file and move the resulting folder into ~/.themes. Then, go into Settings > Appearance > Style > select BeOS-r5-GTK-master.

    Next, click on the Fonts tab. For Default Font, select Swis721 BT Regular size 9, and for Default Monospace Font, select Courier 10 Pitch Regular size 10 (see Font section below for more info).

    Fonts

    There are two essential fonts, which can be easily found through Google searches: Swis721 BT Roman and Courier 10 Pitch for Powerline.

    Once downloaded, move the ttf files into ~/.fonts (remember to turn on “show hidden files and folders” in your file manager, and create the .themes folder if it does not already exist).

    There are two main areas where the fonts need to be set. First, go to Settings > Window Manager > Style tab and set the Title font to Swis721 BT Bold size 9. Then, go to Settings > Appearance > Fonts tab and set the Default Font to Swis721 BT Regular size 9 and set the Default Monospace Font to Courier 10 Pitch Regular size 10.

    Mouse Cursors

    Mouse and Trackpad theme window

    The hand mouse cursor is an integral element of BeOS’s look-and-feel. I opted to use HaikuHand reHash.

    Decompress the downloaded file and move its folder into ~/.icons (remember to turn on “show hidden files and folders” in your file manager, and create the .themes folder if it does not already exist). Then, select HaikuHand reHash in Settings > Mouse and Touchpad > Theme.

    Icons

    Appearance Icons tab

    The isometric view icons for BeOS capture that mid-to-late-1990s era of gesturing towards 3D through 2D designs. Vaporware Mac System 8 Copland exemplified this aesthetic, too (but aspects of it found its way into the eventual MacOS 8 and others incorporated its design elements into shareware like Aaron and the Iconfactory’s innovative icon sets. I created some icons in this style, too.

    To make Xfce as BeOS-like as possible, I used the BeOS-r5-Icons pack.

    Decompress the downloaded file and move it into ~/.icons (remember to turn on “show hidden files and folders” in your file manager, and create the .themes folder if it does not already exist). Then, go to Settings > Appearance > Icons tab > select BeOS-r5-Icons.

    Desktop

    Desktop settings window

    There are BeOS desktop wallpaper pictures that you can download and set as your wallpaper. However, I wanted a simpler solid color background. To achieve this, go to Settings > Desktop. Set Style to “None,” and set Color to “Solid color.” Then, click on the color rectangle to the right of Color, and next, click on the “+” under Custom and enter this hex value for the default deep blue BeOS desktop color: #336698.

    Dock

    Dock Preferences window

    After a lot of head-hitting-the-desk, I settled on using the Xfce’s Panel instead of a more visually interesting dock that used a BeOS-inspired theme (e.g., BeOS-dr8-DockbarX). I was able to get DockbarX installed from source eventually, but I couldn’t get the Xfce4 DockbarX plugin to work with the Xfce Panel. It wasn’t from a lack of trying! It’s worth trying to get those installed–you might have better luck. For me, I needed to move on, so I settled on customizing the Xfce panel to meet my needs and fit the BeOS aesthetic well enough. I went to Settings > Panel > Display tabl to set Panel 1 in Deskbar Mode, set the Row size to 48 with 1 row and ticked “Automatically increase the length. On the Appearance tab, I set the Fixed icon size to 48.

    Applications Menu settings within Panel settings

    On the Items tab, I clicked the preferences for the Applications Menu, removed the Button title and changed the Icon to the isometric 3D Be logo (this will be an option after you’ve installed the icons pack as described above in the Icons section).

    It would be easy to configure the panel to be more like the original Deskbar in BeOS, too. The main changes needed would be to increase the Number of rows to 4 or 5, change the Application menu icon to the flat “BeOS” logo icon (included in the icon pack installation in the Icons section above).

    And, it’s important to remember that there was not one, eternal version of BeOS. As with any developed software, it changed over time with its UI and look-and-feel changing with it. For me, the 1996 Developer Release is what I remember most because I ran it on bare metal on my PowerMacintosh 8500/120. It continued to evolve and change after that in ways that I am less familiar with.

    QMMP/Winamp Skin

    If you use QMMP for listening to music on your computer, you’ll need to grab a Winamp skin to give it the BeOS look and title bar. BeAmp Too is my favorite. There are a few others available if you search for “beos” on the Winamp Skin Museum.

    Whichever one you choose, download the zip file for the theme to your Downloads folder. Then, open QMMP, right click on the title bar and choose Settings, click on the Appearances section on the left, click the Skins tab, and then click on “Add…” at the bottom, navigate to your downloaded theme zip file and select it. QMMP will copy the file into the ~/.qmmp/skins directory for you. Select the theme on the Appearances > Skins tab to activate the theme.

    Other Tweaks

    The following are other tweaks to Xfce that I prefer for daily use.

    Disable overlay/auto hiding scrollbars

    Edit /etc/environment and add the line

    GTK_OVERLAY_SCROLLING=0 

    Save the file. Logout and login to see the change take effect.

    White font for desktop items

    Go to ~/.config/gtk-3.0/ and create a file named gtk.css (edit this file if it already exists). Add these lines to it:

    XfdesktopIconView.label {
        color: white;
    }

    Save the file. Logout and login to see the change take effect.

    Consistent Scroll Bar Speed

    In folders with many files, I have noticed that if I begin scrolling but slow down a little, the speed of scrolling after that point for the rest of my mouse-down drag will be EXCEEDINGLY slow. This is by design–a feature called zoom scrolling. Well, I don’t like it. If you don’t like it either, you can tame it by setting the trigger time to longer than the default of 500 milliseconds. To do this, go to ~/.config/gtk-3.0/ and create a file named settings.ini (edit this file if it already exists). Add these lines to it:

    [Settings]
    gtk-long-press-time=5000

    Save the file. Logout and login to see the change take effect.

    Thanks to:

    An unnamed Reddit user (their account has been deleted) posted an excellent write up of their BeOS-r5-XFCE theming of XFCE in r/unixporn that gave me a roadmap for what was possible.

    Metsatron, Roberto21, Retardtonic, and Xu Zhen for their respective work on the components that make this customization possible.

    The Debian community for Bookworm.

    And thanks to the Haiku OS developers who are keeping the BeOS dream alive!

  • Updates to the Generative AI and Pedagogy Bibliography

    A cute humanoid robot writing at a desk with bookshelf in background. Image created with Stable Diffusion.

    Over the weekend, I made some significant updates to the Generative AI and Pedagogy Bibliography and Resource List page, which includes background, debates, teaching approaches, applications, disciplinary research, and a list of online resources. I started it as a place to organize my own research while sharing it back out to others.

    It now features a table of contents at the top of the page under the introduction.

    I added about 50 articles and books to the bibliography, which now contains 232 sources.

    And, I added three links to the resource list at the bottom of the page which brings it to 42 links.

    I will periodically add more entries to the list as my own research progresses. But, it’s important to note that this bibliography isn’t meant to be exhaustive.

  • Brief Technical Communication Program Administration Reading List

    Classroom arranged in rows with computer monitors at each chair.

    The City Tech English Department asked me to step up as Director of the B.S. in Professional and Technical Writing Program at the start of Spring 2021.

    The following list of books, anthologies, and articles have been helpful to me as I work to better understand program administration, development, assessment, and internships.

    Bridgeford, Tracy, Karla Saari Kitalong, and Bill Williamson, editors. Sharing Our Intellectual Traces: Narrative Reflections from Administrators of Professional, Technical, and Scientific Communication Programs. Baywood Publishing Company, 2014.

    Elliot, Norbert and Margaret Kilduff. “Technical Writing in a Technological University: Attitudes of Department Chairs.” Journal of Technical Writing and Communication, vol. 21, no. 4, 1991, pp. 411-424.

    Franke, David, Alex Reid, and Anthony DiRenzo, editors. Design Discourse: Composing and Revising Programs in Professional and Technical Writing. WAC Clearinghouse, 2010.

    Huot, Brian. (Re) Articulating Writing Assessment for Teaching and Learning. Utah State UP, 2002.

    O’Neill, Peggy, Cindy Moore, and Brian Huot. A Guide to College Writing Assessment. Utah State UP, 2009.

    Sapp, David Alan. “The Lone Ranger as Technical Writing Program Administrator.” Journal of Business and Technical Communication, vol. 20, no. 2, April 2006, pp. 200-219.

    Selting, Bonita R. “Conversations with Technical Writing Teachers: Defining a Problem.” Technical Communication Quarterly, vol. 11, no. 3, 2002, pp. 251-266.

    Sides, Charles H. and Ann Mrvica, editors. Internships: Theory and Practice. Baywood Publishing Company, 2007.