Everyone knows what makes each authors and editors joyful: a clean, streamlined publication course of the place the trail from draft to printed article is fast and painless.
We additionally know that lots of our contributors—old-timers and new ones alike—won’t have plenty of expertise working with WordPress, the software program powering our impartial publication, and particularly with its block editor. We put collectively this information to give you concrete pointers, and to deal with a few of the frequent questions authors have requested us. You may learn this put up from prime to backside (particularly you probably have zero block-editor expertise), or leap forward to the sections which might be related to your present wants.
What’s the block editor?
The publishing instrument on the core of our web site is the block editor. You could find ample sources on its varied parts and options on the WordPress documentation web site; in case you’ve by no means used it earlier than, a very good place to start out is this web page, which explains the essential actions you possibly can take when utilizing the editor and provides a transparent legend for the various buttons and symbols you see round (and inside) your content material.
Needless to say in case you’ve already used the block editor previously as a web site admin or editor, the view you’ll see as a TDS creator goes to be a bit totally different. We needed to give you a targeted drafting setting with minimal distractions, so solely the instruments and choices you’ll have to format your articles might be seen.
How do I begin a brand new draft?
Every time you land in your creator dashboard on our Contributor Portal, you can begin a brand new draft by clicking on Posts → Add New Publish:

If you have already got a number of drafts on our web site in varied states of completion, clicking on this hyperlink will take you on to a listing of your articles; simply select the one you’d prefer to work on.
What are the important parts that every one TDS articles will need to have?
As you most likely know by now, TDS may be very versatile by way of article codecs, views, and writing tone. However each article will need to have the next parts in place earlier than we are able to publish it.
Title
A fascinating, descriptive, concise title is crucial. Sort it into the highest textual content subject above your article’s content material, and also you’re all set:

Bonus factors: be certain that your title is written in title case — for instance, “My Title Is Irresistible and Succinct, however Not Clickbait-y,” relatively than “My title is irresistible and succinct, however not clickbait-y.” (The latter is sentence case, which we reserve on your subtitle.)
Subtitle
Talking of subtitles: you want one! Brevity is nice — the thought is so as to add only a bit extra context to your title and enhance the percentages that potential readers resolve to click on in your article.
Within the block editor, the subtitle known as a subheading, and also you add it straight into — you guessed it — the subheading subject, which you’ll discover within the put up settings sidebar, simply to the precise of the article’s content material:

For those who’re feeling a little bit bit extra adventurous, copy and paste your subtitle (sorry, subheading) into the Publish Excerpt subject, which is close to the highest of the exact same put up settings sidebar. (For those who’re not feeling that adventurous, no worries — our editors will care for that one for you.)

Featured picture
Each article wants one! Whether or not you discover yours on-line (copyright-free, after all), create it your self, or generate one with an AI instrument, it’s crucial visible aspect in your article, so it’s value spending a couple of minutes on this selection. (Listed here are some concepts and steerage in case you’re undecided how you can go about it.)
When you’re prepared, add your picture to its designated Featured picture slot, not into the physique of your article. Simply click on on the Set featured picture button within the put up settings sidebar.

To convey true tears of pleasure to your editors’ eyes, as soon as the picture is uploaded, don’t overlook so as to add a caption with the required sourcing particulars:

Tags and Classes
Be happy so as to add one class and as much as 5 tags to your articles. Whereas that is an important aspect, it’s one we’re joyful to care for for you — so in case you’re undecided which of them to decide on, simply depart these to us.

Word: we actually imagine within the top-notch high quality of all the articles we publish on TDS, however we ask that you simply don’t add our featured tags (like Deep Dives or Editors’ Choose) your self. Our workforce considers each article, and we then add these tags on our finish to a handful of articles every day.
The most typical blocks you’ll use (and how you can use them)
Paragraph
That is the place the textual content of your article goes — which is why the Paragraph block is probably going going to be the one you employ most continuously. Place your cursor anyplace within the paragraph to make the choices menu seen, and spotlight any phrases to which you’d like so as to add particular types like daring, italic, and inline code
, amongst others.

Heading
Creating a transparent structural hierarchy inside your article helps each readers and engines like google navigate your content material. Add a brand new heading everytime you begin a brand new part, and select the precise one relying on its place inside your article.

H1 headings ought to be reserved on your article’s title, so don’t add any extra of these within the physique of your put up. H2 headings are for brand new sections, and in case your bigger sections comprise shorter subsections, you should utilize H3 or H4 headings as wanted.
Picture
Use the Picture block so as to add most visible media to your article —charts, screenshots, animations, and so forth. An important factor to recollect is that you simply shouldn’t copy-and-paste photos into the block editor — you might want to add each media file on to our web site’s Media Library.

As soon as uploaded, nonetheless, you possibly can re-use the identical picture a number of instances inside the similar article or throughout a number of articles.
Don’t overlook so as to add a picture caption to your photos — that’s the place you present readers (and your TDS editors) with the required details about your picture supply and licensing standing.

For those who may use a fast refresher on our picture tips, we’ve obtained you coated.
Quote
Quote blocks are a visible method for highlighting particular factors or concepts, or for quoting longer passages from exterior sources.
Utilizing them sparingly could be very efficient, however don’t overdo it — identical to daring or italicized textual content, Quote blocks can rapidly turn out to be distracting.
Listing
Whether or not on your…
- desk of contents,
- key takeaways,
- or some other aspect in your article that may profit from a neat, bulleted association…
…the Listing block ought to be your go-to. The block editor will robotically detect in case you’re creating numbered or unordered lists when you sort within the first merchandise.
So as to add a nested checklist inside your checklist, simply begin a brand new merchandise and click on your tab button.
Separator
Generally, a heading may really feel inadequate for creating a visible break between or inside sections.
In these circumstances, use the Separator block — simply be sure to choose the Dotted model, which is the one we selected as our default on TDS:

Prismatic (for code blocks)
Many (many!) of our articles characteristic code, and plenty of it, so we needed to ensure it appears to be like neat, clear, {and professional}. To try this, we’ve enabled the Prismatic block, which ought to be your default selection for embedding longer code blocks into your article. (One fundamental exception: in case you resolve to use GitHub Gists as a substitute, which we additionally welcome.)
Be happy to sort in your code or to copy-and-paste it from an IDE. The one essential factor you might want to keep in mind, nonetheless, is to select the block’s programming language — in any other case, your code won’t show correctly on the TDS frontend. Happily, choosing the precise language is a breeze, and you are able to do it straight out of your block settings sidebar:

With dozens of programming languages to select from, you’re nearly sure to search out the one you want. On the off probability you don’t, choose one which’s shut sufficient, syntax-wise, to the unique, up-and-coming language you’re coding in. (For those who ever simply wish to current plaintext inside a code block, your greatest guess is to go along with HTML.)
Shortcode (for LaTeX notations)
In case your article contains plenty of formulation (or formulae, in case you insist), equations, and different math notations, you possibly can guarantee they give the impression of being nice on TDS by inserting your LaTeX markup right into a Shortcode block. There are a few totally different approaches for doing that, and we strongly advocate studying the documentation by MathJax-LaTeX, which is the WordPress plugin powering LaTeX on our web site.
In case your wants aren’t as elaborate, you may also…
- Immediately add a smattering of ≠, π, or ∑ (to call a number of examples) utilizing useful keyboard shortcuts.
- Create your fancy equations on the exterior instrument of your selection, and take a screenshot — which you’ll then add into an Picture block.
Desk
Nice for evaluating experiment outcomes, product options, and extra, the Desk block makes creating glossy tables very simple — simply resolve what number of columns and rows you want and also you’re just about able to go.

You may additional customise your desk utilizing the block settings sidebar (to decide on fixed-width cells, add a header part, and so forth.).
Embeds
We’ve enabled a number of continuously used embed sorts for authors, permitting you to seamlessly combine content material from different platforms into your articles.
GitHub Gists
Sharing your code through Gists is frequent amongst information and ML professionals, and this block makes it potential to increase this observe into your TDS articles. It requires two easy steps:
- On GitHub, copy the embed hyperlink out of your GitHub Gist:

2. Add a GitHub Gist Embed block to your article, and, within the block settings sidebar, paste the embed hyperlink. You must instantly see a preview of your Gist.

You may add as many Gists as you’d like, and their formatting will keep the identical on our web site.
Media embeds
For those who’d prefer to embed tweets, YouTube movies, and different embeddable media from exterior platforms, click on the + image within the block editor, sort embed, and also you’ll see the assorted choices at your disposal.

Then, paste within the URL of the media you’d prefer to embed into the block, and let the editor do the remainder. Word that for some platforms, you may want a particular embed hyperlink.
For those who’d prefer to embed different media however are usually not certain if it’s potential or how you can go about it, simply attain out — we’ll do our greatest to discover a answer for you.
How can I ask for assist with my draft?
We’re glad you requested! For those who ever run into any concern through the evaluate course of, whereas drafting your article, and even after your put up is printed, you possibly can all the time attain out straight from the block editor. Simply spotlight any phrase, click on on the brand new remark image, and kind in your query, word, or concern.

Two vital issues to recollect:
- For the quickest response time, tag considered one of our workforce members once you enter your remark — typing the @ image will present you a listing of the editors you possibly can ping.

- At all times save your draft after you put up a remark. This ensures your remark doesn’t disappear into skinny air in case you make modifications to your draft, and sends a notification to the editor you pinged.
My draft is nice to go! What’s subsequent?
Congrats! You’re nearly executed. Listed here are two belongings you ought to do earlier than submitting your article for evaluate — and one factor you completely should do for us to really evaluate it.
- Giving your article a remaining proofread is rarely a nasty thought (we are able to’t overstate the advantages of sending us a clear first draft).
- We additionally advocate you take a look at your draft preview — it’s enjoyable to see how your article would look as soon as it’s printed, and it additionally provides you an opportunity to double-check all the pieces is formatted and displayed as you’d meant. To preview your article, click on on the laptop computer image (we expect it’s a laptop computer image?) close to the highest of the editor display.

- Lastly, please don’t overlook to submit your article for evaluate — which you are able to do by clicking on the (drumroll, please) Submit for Assessment button on the top-right nook of the block editor.

When you click on on the button, your article enters our evaluate queue; you possibly can nonetheless make modifications to it, but it surely’s greatest to maintain these to a minimal when you obtain a notification that it’s in evaluate.
For those who nonetheless have any questions or run into any points whereas drafting and formatting your article, really feel to achieve out through electronic mail or by pinging us straight out of your article.