#dang there are a lot of tags related to intro posts | Explore Tumblr posts and blogs

bloopitynoot · 2 months ago

Text

Reading SVSSS: Chapter 3

For those who don't know, I am reading SVSSS for the first time and sharing my thoughts!

If you have not read it, there will be spoilers! Consider this a warning.

Also- if you want to follow along, I am aiming to post updates daily. You can find all the posts in the tag bloopitynoot reads SVSSS. You can also check out the intro post for context on my read.

oh, that's good, he's (Shen Qingqiu/Shen Yuan) not dead p135

also not related to my read, but this time I am actually writing at my table (instead of cocooned in a blanket on my couch) so hopefully these note are easier to read (Read: I am trying to have neater handwriting for ✨aesthetic✨). All I need with my notes, book, and tea is a candle and i'd be living my ancient academic fantasy.

If anyone wants to know this chapter is accompanied by a white tea that tastes like loquats. It's my favourite nostalgic tea. My family used to travel south when I was small and my grandparent's house there had a loquat tree. I haven't had loquats in over a decade (canada lol) but this tea tastes jut like them.

Anyways! Back to SVSSS!

Give me patience: the amount of dislike I have anytime Ming Fan is present p135

oh dang, this boy can cook! p138

Re: this boy can cook- Bye LOL "Luo Binghe's excellent cooking skills were his foremost lady-killing technique." p138

boo, I am upset that the Abyss scenario still needs to happen (But I get it, of course it can't be that easy- we do need plot for this book) p139

I can't XD he really is falling into the plot/character of Protagonists Love Interest. First the congee cooking and no the "Poison cure" p142

WAIT. THE CURE FOR THE POSION. wut p143

RE: WAIT: I am crying LOL

But like could he 👀 "Like, he knew that the going at it with the protagonist could have cured the poison, but like he could do that! Could he? Ha ha ha ha..." p145

Not Liu Qingge over here thinking Shen Qingqiu is possessed (not really wrong though) p147

once again we have Ming Fan -> honestly I would not be surprised if he ended up the new villain/scum character role p148 there is nothing likeable about him

this line is killing me "Shen Qingqiu was astoundingly oblivious to the fact that, thanks to the divine wingman abilities of his useless teammate, Ming Fan, Luo BInghe's favor has again risen to a new high" p.150

Oh god, he's in Luo Binghe's dream world. I am so nervous for this. p. 152

Dang. Why so many deductions for failure -1000 is a LOT for him p154

okay but this dream subplot is feeding my theory that Shen Qingqiu is switching character roles from villain to Love Interest p155

Oh no :( not his childhood bullies p160

omg and now his mom's death p161

Shen Qingqiu has been taking a constant beating for 164 pages- how is he not dead p164

LOL Shen Qingqiu really said "i'm not paid enough for this emotional labour" p167

Also Shen Qingqiu "I finished my friendship performance; I can finally leave work now" p169 what a vibe

Even the Dream Demon Lord is over how much Luo Binghe talks about Shen Qingqiu (p172)

uuuugh the foreshadowing RE: if you don't learn the demon path and the seal breaks you are basically fucked p.173

You tell that demon, Luo Binghe! RE: "right now, you are discussing terms with me, and you are free to say anything...but if you harm Shizun, any agreement is void!" p177

LOL "Aura of Badassery" p177

Shen Qingqiu after a very bad no good series of days "pls I dont want to see you omg leave me alone I am v tired" p179 this guy can't catch a break

The dichotomy of Shen Yuan acting in this though. Outward: I definitely can handle this. Inward: I'm so fucking scared, I do not got this. Is so real p180

Shen Qingqiu "I want this kid to remain optimistic and feel positive with his heritage (so he does not turn evil and mass murder me and everyone else)"Luo Binghe "I am going to be the strongest of strong possible so that I can protect Shen Qingqiu" p182

Oh gods, not him asking him to move in with him (to basically have a servant but like Luo Binghe has just had his entire life changed) p185

okay so age check- suddenly he's 15??? I thought this kid was 14 like 3 days ago?? p186

Points to Shen Yuan though for noting that how Luo Binghe was being treated was child abuse. p188

YAY! He's going to train with Meng Mo (also it made me laugh at how pissed Meng Mo is about not having the teacher title) p190

That's all for this chapter!

next one aiming for tomorrow :D

#bloopitynoot reads svsss #svsss spoilers #mxtx svsss #svsss #solid chapter though #so much character interpersonal relationship growth #not just between Shen Qingqiu and Luo Binghe #but also Shen Qingqiu and the sect masters

14 notes · View notes

ghosty-schnibibit · 5 years ago

Text

late liveblog b/c i took the time to listen to the first ep over again :P

hey travis? hey- hey travis??? three in the morning travis?????

for real tho i am extremely excited for the new ep, and finally found some time to listen to it!!! this time i won’t have to avoid tumblr for like a week lmao

i can hear the excitement in travis's voice to do the "previously on the adventure zone" message and it fills my heart with happiness

god this music is just so good

how the fuck is that right??? i've played a rouge before and she in no way had a +8 to stealth

let him have this justin

the spectral cat from last ep!

i love argo so much holy shit

that is indeed very upsetting

awww, poor bud :(

oh baby, oh fitzroy my dipshit baby

"it isssss... cat" i love him so much

... argo has never seen a cat before??? poor baby

is he legit afraid of the cat

the voice is already slipping lmao

oh that's adorable! campus kitties :D

that's not a real thing fitzroy

so like a campus card, fun! i had the same thing at tcc lol

i think so? if i remember correctly from the past ep it's shared

"gary doesn't have time for love" :'(

he saw that one post i'm dying

it sounds like trav asked them beforehand, that's a neat way to plan for interactions before they happen and i like it

the dread pirate mary berry

"crush the beef" what does that mean fitzroy

what is this voice clint, you did not have this voice last ep, you've gone from vaguely ned to vaguely merle's fake scottish accent

"this turns to ash in my mouth" i love this

thank you griffin for this in character backstory opportunity

"to be by his side... kickin'" sounds to me like everyone's argo revenge plot theories might be correct

yummy! :D

mind chefs

fitzroy my sweet dipshit

he's a sweet sweets boy c:

"he's a failure" yes and i adore him

... god this class is just me all over

riveau, cool, thank you for the spelling notes

oh dang, that's a cool mechanic, i can see this wielding some potential narrative heaviness later on

i'd say about... a minute is good

i am so nervous for argo holy shit

argo's laying it on thick enough that i genuinely cannot tell whether or not clint got a good or bad roll

that was indeed a seventeen! go clint

... argo :(((

i legit cannot tell if this is argo bluffing the prof or if this is just clint being clint b/c merle and ned both pulled the "so am i getting paid now?" bit multiple times

i trust justin to not make this audio poision

owl professor :D

the dramatic music travis holy shit

so basically the middle ages lmao

"the golden age of accounting" t r a v i s

i can hear justin nearly combusting in the bg trying not to laugh and i am right there with him, this is such good world building but holy shit travis

basically reaffirming from last ep that the entire premise of this arc is the entertainment industry in a post scarcity economy, cool cool

oh my god this is such a mood

i adore bud so much

"sweet bird in heaven" pfff

so this prof is basically capitalism personified... thanks, i hate him

bud is 18 y/o me in my required "intro to college skills" class r/n

i am dying inside, this is so close to my own high school and college experiences, i feel like screaming on bud's behalf

I'M HAVING AP CALC FLASHBACKS TRAVIS, PLEASE LET IT E N D

"and you know what? i believe in you" i don't believe in me right now trav, i'm a 22 y/o adult and i have no idea what most of these words mean

oh god i just got the mental picture of all the other people in this class watching this exchange and it brought new levels of hilarity and abject horror to the situation, jfc i am d y i n g

this owl really is a personification of capitalism, huh? grasping at straws and concocting elaborate fantasy scenarios, desperate to prove that his system works even though it necessitates loss and goes against humanity’s inherently cooperative nature

travis this has gone on for like 15 minutes real time, f r e e m e

"why did the mind make acorn?" i have never related to a taz pc more than i have in this moment, holy shit justin

sign! me! the! fuck! up!

yes i did trav!!! i loved it and i'm loving this! i am so proud of you!!!!!

aww, poor dude :(

fun! this sounds like a really interesting idea

fitzroy continuing to be salty about his name lol

i want to see the skeletons do the charleston so bad, but more then anything i want rainier to be my girlfriend

poor argo lmao

awww, fun!

f u r b y

nice! :D

JESUS ARGO

nice rolls all around!

go bud!!! ^u^

i don't see how that would help argo???

i'm liking a lot of the skills travis is adding

yes! block for my gf mapleboy!!!

"im feeling dastardly" fitzroy baby, you're allowed to use magic, what you’re doing isn't cheating you absolute dummy

WAIT WHAT

this is badass holy shit, i love these teachers

jesus fitzroy my dude

funky twenty! nice

natural twenty! even nicer

aww, sweet sacrifice boy

fitzroy nearly killed him holy shit

festo???

oh fun! that sounds adorable!

oh god, nm, this character is so weird

jesus christ i am so creeped out

oh my god fitzroy what the fuck, you turned a woman into a fish

aww baby :(((

i am fucking depressed now holy shit

okay, i like festo now

that was a cute lil noise

awww!!! magic pet, i am so excited to see what fitz is going to pick

lil crab buddy :D

poor fitzroy holy shit

oh it's the rouge professor!

i do not like the creepy whisper voice travis, this is legit creeping me out

i am so fucking worried for argo

who is mariah??? oooh i am so intrigued

rain and stone... this is so interesting holy shit

awwwww!!!!!

"this is nothing" pfff

my sweet boys :')

i! am! so! freaking! pumped!!!

this was another really great episode! i know we’re still in set-up territory as far as how the plot is progressing but i’m already so intrigued in the world trav has made. there’s already so much mystery and foreshadowing going on, both in regard to the world and the character’s motivations and i am here for it!

i’m actually typing this around 5:30 am and queuing it for later so it doesn’t get buried in the tag, but i cannot wait to see all the art of this ep, especially of snippy lol. see you guys next right thursday~! ^u^

#taz #the adventure zone #taz spoilers #taz graduation #ghosty liveblogs taz #i'm gonna try my damnedest not to be late next time but it couldn't be helped

10 notes · View notes

suzanneshannon · 5 years ago

Text

Advice for Technical Writing

In advance of a recent podcast with the incredible technical writer and Smashing Magazine editor-in-chief Rachel Andrew, I gathered up a bunch of thoughts and references on the subject of technical writing. So many smart people have said a lot of smart things over the years that I thought I'd round up some of my favorite advice and sprinkle in my own experiences, as someone who has also done his fair share of technical writing and editing.

There is a much larger world of technical writing out there. My experience and interest is largely about web technology and blogging, so I'm coming at it from that angle and many of the people I quote throughout are in that same boat.

Picking something to write about

If you want to write for CSS-Tricks and you ask me what you should write about, I'm probably going to turn that question around on you. It's likely I don't know you well enough to pick the perfect topic for you. More importantly, what I really want you to write about is something that is personal and important to you. Articles rooted in recent excitement about a particular idea or technology always come out better than dictated assignments.

My best advice:

Write the article you wish you found when you googled something.

— Chris Coyier (@chriscoyier) October 30, 2017

That said, I do maintain a list of ideas specifically for this site. Any writing can be done on assignment and sometimes that elicits the spark needed for something great and on-target for the audience of a site.

Write at the moment of learning

The moment you learn something is the best time to write. It's fresh in your mind and you can remember what it was like before you understood it. You also understand what it takes to go from not knowing to knowing it. That's the journey you need to take people on.

If you don't have time, at least try to capture the vibe wherever you save your ideas. Don't just write down "dataset." Write down some quick notes like, "I didn't realize DOM elements had a .dataset property for getting and setting data attributes. I wonder if it's better to use that than getAttribute." That way, you'll be able to reload that realization in your brain when you revisit the idea.

What have you learned in just the last few days? I bet there is a blog post there. Manuel Matuzovic does an excellent job of putting this into practice with the "Today I Learned" (TIL) section of his blog.

Comparing technologies is an underused format

Here's some advice Rachel shared that I don't see taken advantage of nearly enough:

There is a sweet spot for writing technical posts and tutorials. Write for the professional who hasn't had time to learn that thing yet, and link it back to things they already know. For example explaining a modern JS technique to someone who knows jQuery.

— Rachel Andrew (@rachelandrew) February 20, 2019

Tell me about how this new framework relates to Backbone. Tell me how this CMS relates to WordPress. Tell me how some technology connects to another technology that is safe to assume is more widely understood.

Technology changes a lot, but what technology does doesn't change all that much.

Careful with that intro

The main comment I add on tutorials I review is to ask for an intro that describes what the tutorial is about. I'm 600 words in and still don't know what the tutorial is about and who it is for. #writing

— Rachel Andrew (@rachelandrew) January 5, 2018

Not getting to the point right at the top of technical articles is a dang epidemic. The start of a technical article is not the time to wax poetic or drop some cliché light philosophy like, "Web design sure has changed a lot." You don't have to be boring, but you do need to tell me what this article is going to get into and who it is for.

Brian Rinaldi says:

“Does the title make the article sound interesting?” If the title interests a reader, they’ll typically read the intro and decide, “Is it worth my time reading the whole thing?” A common mistake I see in a lot of technical posts is either too much introduction or, alternatively, far too little.

A single well-written paragraph can set the stage for a technical blog post.

Careful with the title, too

I remember a conversation from years ago with content strategist Erin Kissane where she strongly advised me to choose boring titles for everything. Not just the title of blog posts, but for everything, including the names of sections, tags, and even subheadings within posts.

Here's the thing with boring: it works. Boring isn't the right word either; it's clarity. The world is full of clickbait, and maybe that's effective in some genres, but technical blogging isn't one of them.

A nice clear blog post title: Getting Started with GraphQL, Phoenix, and React by Margaret Williford

A terrible version of the same: Build a web app with modern technologies in 30 minutes!

What's a web app? What technologies? What's modern about them? What's with the weird time limit?

SEO matters and Margaret's article is going to do a lot better in both the short and long term with that clear title.

The outro

Ben Halpern says that the next most important thing after the intro is:

[...] the last paragraph.

People don't read top-to-bottom the moment when they arrive, so there is a good chance it's the second paragraph people read. Personally, I find the beginning a lot more important than the ending, but there is a certain art to the ending as well.

A lot of people just <h2>Conclusion</h2> and write a few words about what was just went over. Honestly, I don't hate that. It falls into this time tested pattern:

Tell 'em what you're gonna tell 'em

Tell 'em

Tell 'em what you told 'em

That helps your message sink in and brings things full circle. Technical blogging isn't terribly different from marketing in that sense. You're trying to get people to understand something and you're using whatever tricks you need to to get the job done. A little repetition is a classic trick.

Make it scannable

Brian Rinaldi says:

[...] the wall of text can be easily be made less intimidating and appear much more visually appealing through the use of visual elements that break it up. The easiest is to simply place section subheadings throughout your post.

I agree: subheadings are probably the easiest and most powerful trick for scannability.

Other methods:

Lists: Like what I'm doing right now! I didn't have to use a list. Paragraphs might have worked as well, but a list makes contextual sense here and is probably tricking some of you into reading this. Or at least scanning it and getting some key points in the process.

Images: Please make them relevant and contextual. Skip the funny GIF. Screenshots are often great in a technical context because they provide a visual to what might otherwise be a difficult concept to explain. I like Unsplash for thematic imagery, too, but you can do better than a random picture of trees, a woman drinking coffee, or a random rack of servers.

Illustrations: The abstract nature of an illustration is your friend. It tricks people into having a quick thought about what you are describing. They generally take a little work to pull off, but the pay-off for you and the reader can be huge.

Videos: You can't simply drop a 42-minute video in the middle of a blog post, but if you can make it clear that you are demonstrating something visual and the video is less than a minute, it can be a powerful choice. You've always got <video autoplay muted loop controls> as well to make it GIF-like.

Blocks of code: Technical blog posts are often about code. Don't avoid code, embrace it. I love how Dan Abramov sprinkles in code blocks in blog posts not so much to demonstrate syntax and setup, but to make points. I'm going to recommend Embedded Pens as well, because they're fully interactive demoes in addition to serving as code blocks.

Tables: Don't forget about tabular data! Presenting information (particularly data or definitions) in a table makes it more understandable than it would have been any other way.

Collapsing sections: The <details>/<summary> elements make quick work of collapsible content. If you've got a large section of content that is good to be there but doesn't need to be read by everyone, collapse it! Our reference guide of media queries for devices is a decent example of this in action.

Whatever you pick here, you should pick things that help enhance the points you're making even if in some ways it feels like trickery. It's trickery to help readability, and that's a good thing.

My favorite technique? A little bit of design. Use design principals like spacing, color, and alignment to help the readability of posts. We even go so far as to art direct some posts where design can enhance the central point being made.

The point here isn't to do away with walls of text altogether. Sometimes that's exactly what's needed because you're asking a reader to deeply read a passage that they otherwise wouldn't get what's needed from the content. However, more often than not, a post can strongly benefit from some healthy use of white space.

Use an active voice

I find this one a little tricky to wrap my head around, but Katy Decorah has a great presentation about technical writing that explains this point in great detail. It's kinda like using present tense and stating a point directly rather than passively.

Passive: "After the file is downloaded..." Active: "After you download the file..."

Passive: "The request is processed by the server." Active: "The server processes the request."

Here's another clear explanation with examples by Neal Whitman, read by Mignon Fogarty (Grammar Girl):

The key point is made about a minute into the recording.

There are lots of words to avoid

"Just" is a big one. Brad Frost:

“Just” makes me feel like an idiot. “Just” presumes I come from a specific background, studied certain courses in university, am fluent in certain technologies, and have read all the right books, articles, and resources. “Just” is a dangerous word.

There are plenty of others to avoid, which which I've written about before. Read the comments in that last link. Long story short: there are lots of words that do more harm than good in technical writing, not only because they can come across as preachy, but because they usually don't help the sentences where they're used. Try taking "just" out of any sentence. The sentence will still make sense without it.

Simply Clearly Just Of course Everyone knows Easy However So Basically Turns out In order to Very

Be mindful of your tone

Tone is concerned with how you say something in consideration of the context. For example, you wouldn't deliver bad news to someone with a happy tone. The way you express yourself ought to be aligned with the situation.

This is our tone goal on this site:

Friendly. Authoritative. Welcoming. We're all in this together. Flexible (nondogmatic about ideas). Thankful.

MailChimp has a very extensive guide to theirs.

It's worth pointing out that tone and voice are separate concepts. I like to think of voice as never changing (it's your personality which is a part of who you are) while tone changes to suit the context. In other words, you can have a professional voice while communicating in a friendly tone.

I don't think there is one true tone that is perfect for technical writing, but since the high-level goal of any technical writing is to help someone understand something complicated, you can use tone to help. A joke in the middle of a set of intricate steps is confusing. A bunch! of! excitement! about something might feel out of place or disingenuous, but being drab and lifeless is worse. I'd say if you're writing under your own name, let's feel a little bit of your personality as long as it's not at the cost of clarity. If you're writing under a brand, match what they have established whether it has been codified or not.

Careful about length

The general tendency in technical writing is to write too much rather than too little. Wade Christensen:

Whether trained by school assignments with word minimums or just uncritical, most of us write too much. Beyond approaching each draft with a ruthless cutting mentality, there are several ways to write short from draft one.

Word limits can help, even if they're self-imposed.

I heard from a fledgling editor recently who struggled with his writers submitting posts with high word counts, so he suggested they keep it to 1000-1500 as a guideline and that seemed effective. This post is roughly double the high end there, for comparison.

The real solution, if the resources are there, is ruthless editing.

I personally don't find that writing too long is the only issue. I've had just as many occurrences of writers going too short and not digging into the topic deep enough. I don't like focusing on the length; I like focusing on the clarity of the delivery and usefulness of the content itself.

Side note: Breaking up a post into multiple parts (as separate posts in a series) is not a solution for posts that are too long. In fact, it can exacerbate the problem. Do that only if the different parts are thematically different and can stand alone without the other parts.

Don't stop yourself from writing

There is an invisible force, built from fear, that keeps a lot of people away from technical blogging. "Meh, everybody already knows this," you might think. (They don't). "What if I'm wrong and someone calls me out?" (You aren't wrong if what you're doing is working for you.)

There can still be blockers even if you overcome those fears and start putting words to screen. Here's Max Böck:

There is a thing that happens to me while writing. I start with a fresh idea, excited to shape it into words. But as time passes, I lose confidence.

The trick for Max is not to wait too long and to ignore feelings holding you back:

I’ll publish something as soon as I feel confident that all the important points I want to get across are there. I try to ignore the voice screaming “it’s not ready” just for long enough to push it online.

Jeremy Keith goes so far to say we shouldn't even keep drafts:

I think keeping drafts can be counterproductive. The problem is that, once something is a draft rather than a blog post, it’s likely to stay a draft and never become a blog post. And the longer something stays in draft, the less likely it is to ever see the light of day.

The chances that your writing helps someone is pretty high! Matthias Ott:

Even the smallest post can help someone else out there.

Think you're too inexperienced? You're probably not, but even if you were, a perspective from someone with less experience is still useful. Ali Spittel:

If you have a blog post that contains mostly correct information, or at least your interpretation of the topic, then you're experienced enough. There are lots of excellent posts out there from the perspective of newbies, and they're really important!

Fear is a real thing in writing and dealing with it can be debilitating. While it's primarily geared toward creative writing, The War of Art by Stephen Pressfield is a good read to help break through the fear.

There is no one perfect style

We each have our own unique perspectives and writing styles. One writing style might be more approachable to some, and can therefore help and benefit a large (or even small) number of people in ways you might not expect.

...says Sara Soueidan. She continues:

Just write.

Even if only one person learns something from your article, you’ll feel great, and that you’ve contributed — even if just a little bit — to this amazing community that we’re all constantly learning from.

Technical blog posts don't have to be devoid of creativity. You could create a wonderful technical blog post that is an annotated chat room conversation between two developers learning from each other. Or a blog post that is a series of videos that build on each other.

The more introductory, the higher the bar

The web is saturated with beginner-rated and surface-level blog posts. There's a sea of crash courses, 101s, and intros out there. You've gotta knock it out of the park if you want to stand out from the pack and be useful.

There is no particular change in tone necessarily for a beginner-focused post. You don't need to do the equivalent of talking slowly or talking down. You only need to be clear, and clarity is valuable to readers at any skill level, not to mention appreciated by them as well. A very advanced programmer can and will appreciate the clarity in a technical blog post even if it's something they already understand.

But the bar isn't that high in general

You don't need a decade of experience to write a blog post. I'd say it's closer to a day of experience, a desire to write, and having something to say. I think you'd be surprised at how little you need to do to make a blog post stand out and be read. Put in some effort, make clear points, focus on readability, and you will do well.

I hope the advice in this post helps!

Abstraction is helpful, but real-world examples are sometimes better

Christine writes:

It’s one thing to describe a high-level concept, and another to explain or illustrate how that concept applies to the real world. In technical writing, you’ll often be covering complex or hard-to-understand subjects, so it’s even more important to use a well-placed example or two to showcase why your topic matters, or how it relates to the real world.

I find myself pushing back on code that is too abstract more than I push back on code that is too focused on a real-world use case. I'd rather see ["Charles Adok", "Samantha Frederick"] than ["foo", "bar"] or [a, b] any day, but more importantly, what is then done with that data to make it feel like a relatable programming scenario.

But avoid real-world examples that come at the cost of clarity. If abstraction is useful to drive a complex point home without getting lost in the details, so be it.

Blogging opens doors

Everyone I've ever met who had ever actively blogged has said that blogging has had a positive impact on their career. Besides being a public demonstration of your ability to think and present ideas, it helps you understand things better. To teach is to learn.

I'd attribute my own blogging as the biggest contributor to any success I've had. Here's Khoi Vinh, a designer ten times more successful than I'll ever be:

It’s hard to overstate how important my blog has been, but if I were to try to distill it down into one word, it would be: “amplifier.”

You get better at what you do.

There is no way around it: practice makes you better. The expectations around practice are sometimes very clear and culturally ingrained. In order to get better at playing the piano, you take piano lessons and practice. We all know this. But people also say "Oh, I'm a terrible cook," as if cooking as a skill is somehow fundamentally different than playing the piano and doesn't require the same amount of learning and practice.

You get better at writing by writing more. That is, writing with stakes. Writing and then publicly publishing what you write such that people read it.

You can go to school for writing. You could get a writing coach. My thinking is nothing teaches better than writing often. Whatever it is you sink time into is what you end up getting good at. Is 10,000 hours a good framework for you? Go with it. Heck, I find even people that sit around watching a lot of TV end up being pretty damn good at watching TV.

Your voice alone < A story with context < Stories including others < Research and data along with stories including others

An article where you just say some stuff is OK. You're allowed to say stuff.

But you can do better.

An article where you tell a true story about how something worked for you is better. Context! Now we can better understand where you are coming from when you say your stuff. Plus everybody likes a story.

An article where you combine that with quoting other people's writing and stories is even better. Now you're painting a larger picture and helping validate what you're saying. Context and flavor!

An article where you combine all that with research and data is the best. Now you're being personal, acknowledging a world outside yourself, layering in context, and avoiding being too anecdotal. Kapow! Now you're writing!

Are you pitching?

Read what the site says about guest writing. Here's ours.

Not to scare you off, but 90% of submissions are garbage. Maybe 75% is outright spam and another 15% are people that clearly didn't read anything we had to say about guest posting and are way off base. I can usually tell from the quality of writing in the email itself if they'll be a good guest blogger.

I say things like that, and then feel compelled to remind you the bar isn't that high.

Are there any useful tools?

There probably is, but I don't wanna link you off to tools I can't vouch for. All I use is Dropbox Paper for collaborative writing because the sharing model is easy and allows for co-editing and commenting. Plus Grammarly because it catches a ton of mistakes as you go.

📝🎉

The post Advice for Technical Writing appeared first on CSS-Tricks.

Advice for Technical Writing published first on https://deskbysnafu.tumblr.com/

0 notes