hugovk, to python
@hugovk@mastodon.social avatar
hugovk, to python
@hugovk@mastodon.social avatar

Two recent changes I've made to the Python docs I'm happy about:

📘 Links are underlined, which is important for accessibility.
https://adrianroselli.com/2016/06/on-link-underlines.html

📗 The dated Lucida Grande was the Mac system font a decade ago and used for the docs on Mac (and only Mac). We now use the system font stack, to get a similar result to Linux, Windows, Android and iOS.
https://systemfontstack.com

Before: https://docs.python.org/3.10/tutorial/index.html

After: https://docs.python.org/3.12/tutorial/index.html

#Python #docs #documentation #a11y #accessibility #font

The Python tutorial, shown on macOS with Arial and prose, non-navigational links are underlined.

hugovk,
@hugovk@mastodon.social avatar
anderseknert, to random
@anderseknert@hachyderm.io avatar

If I want to demo some snippet for solving a problem in a few different languages and have a each language under a tab, what would be the best tool for that?

anderseknert, to opensource
@anderseknert@hachyderm.io avatar

Continued research on , and I've gotta say — as much as I like , it's really led us to a place where basically all docs everywhere look the same. Very little in terms of interactive docs or novel / inventive approaches to teaching. I mean, it's not a terrible place to be, just a bit... dull.

historyofpunkrock, to punk
@historyofpunkrock@sfba.social avatar

'Always wear shoes that are good for running or fighting.' — Joe Strummer

marwi, to webxr German
@marwi@mastodon.gamedev.place avatar

We've made a new features trailer for Needle Engine 3.36 ✨

https://youtu.be/VkcLvnK_aeU?si=2VVXWgnIezKzxKqW

hugovk, to python
@hugovk@mastodon.social avatar
chipx86, (edited ) to python
@chipx86@mastodon.online avatar

ReStructuredText writers, where do you like to put your

.. _RefName: <target>

definitions?

While we're at it, what are your personal ReST best practices? Share in the comments!

fast_junkie, to Help
@fast_junkie@mas.to avatar

2/
I went back and tripled checked all the settings... waited the standard 48 hrs... .

Note to those whom suffer the same... when switching providers you have to your domain at @protonmail... THEN add it again...

Man was I pulling my hair out... they need to put that in the !

anderseknert, to opensource
@anderseknert@hachyderm.io avatar

Developer friends – I could use some inspiration! What companies out there do you think provide great developer ?

I like the developer portal, but there must be many I haven't seen. Any suggestions appreciated!

TehPenguin, to random
@TehPenguin@hachyderm.io avatar

I've been helping to investigate a few LLVM and Rust bugs recently, and I keep running into pet peeves with how these bugs are reported, so I'm going to put together some

I don't want to discourage anyone from filing a bug, please do! But... be aware with how you represent the issue that you're seeing.

I also know that there are folks on here who are vastly more knowledgeable than I am, so feel free to suggest corrections, perhaps by filing some sort of report...

TehPenguin,
@TehPenguin@hachyderm.io avatar

If the feature has docs, then please explain how the actual behavior doesn't match the docs.

If you don't like how the feature works, that's not a bug, but you can still ask for the feature to be changed.

If there are no docs, or there's a gap, then please help to fill that gap (adding your own observations in the bug report are a good start).

hugovk, to python
@hugovk@mastodon.social avatar

🆕 When you visit https://docs.python.org you can now hit the forward slash key ➡️ / ⬅️ to highlight the search box, and immediately start typing your query. Try it!

💡 You can use the same shortcut on many other sites, such as PyPI, GitHub, YouTube, Discourse (https://discuss.python.org) and Furo-themed docs (https://devguide.python.org).

Happy searching! ⌨️🔎📚

yugaego, to orgmode

A point not to miss in

Org provides methods to create a link in the correct syntax, to insert it into an Org file, and to follow the link.

The main function is 'org-store-link', called with 'M-x org-store-link'. ... It stores a link to the current location.  

I didn't realize such stored links then suggested for completion on 'M-x org-insert-link ('C-c C-l).

A Tip! Try 'org-store-link' with

(setq org-id-link-to-org-use-id 'use-existing)

pixelfed, to random
@pixelfed@mastodon.social avatar

✨ Explore our new API docs

Please keep in mind this is a beta preview, we are working hard to finish this!

https://beta-preview.pixelfed.io

Boosts greatly appreciated!

Krysalia, to internet French
@Krysalia@mastodon.social avatar

HAHAHAHAHAHAHA

oh, not a joke 😳 ?

et donc ouais, quand on veut stocker ses infos de profil facebook dans un truc comme google doc, le transfert refuse de fonctionner si on n'autorise "que les fichiers qui viennent de facebook". Il faut EN PLUS cocher la case obligatoire "TOUS les fichiers google docs" que Meta a ainsi le droit de modifier, éditer, supprimer etc.

BAH VOYONS --' .

daria, to python

Anyone else feeling like could use a revamp? 🐍

maikelthedev, to random

I wonder how does account verification work in Calckey/Hajkey

@kainoa @supakaity @panos would you know?

Btw, can someone point me to the right direction of an official documentation so that I can stop asking this silly questions here? The closest thing I found googling is this which can't be called documentation.

Both repo and website should have a direct access to the documentation having answers to this questions, including that the api docs are in every instance/api-docs.

dansup, (edited ) to Pixelfed
@dansup@mastodon.social avatar

Edit: It's live! https://pixelfed.github.io/docs-next/

Really looking forward to shipping the new https://docs.pixelfed.org website!

Some highlights:
✨ Simpler Setup
✨ Federation Spec
✨ Complete API docs

This is long overdue and will help admins, client developers and fediverse developers alike 😉

cfnptr, to cpp
@cfnptr@mastodon.gamedev.place avatar

Made a custom css theme for Doxygen. At least now it doesn't look like it's from the 90's 🙂

joachim, to random
@joachim@drupal.community avatar

Some excellent at https://bpmn.io/toolkit/bpmn-js/walkthrough/#bpmn-js-internals by @bpmn_io. I know NOTHING about any of the technologies, and yet that diagram makes it looks like something understandable. Simple clear sentences like 'We use diagram-js to draw shapes and connections' help too.

hugovk, to python
@hugovk@mastodon.social avatar

I wrote a thing!

How to activate tabs for your OS in Sphinx

https://dev.to/hugovk/sphinx-docs-how-to-activate-tabs-for-your-os-pd3

On pages like https://devguide.python.org and https://pillow.readthedocs.io/en/latest/installation/basic-installation.html we have tabs with specific instructions per operating system.

You can add a bit of JavaScript to automatically activate the relevant tab based on the reader's operating system, so they see the relevant info sooner.

petrnuska, to brainfood
@petrnuska@mastodon.world avatar

#AcademicJob

Tenure Track Position in Fiction and Documentary Directing and Editing

@ Toronto Metropolitan University

https://hr.cf.torontomu.ca/ams/faculty/preview.cfm?posting_id=550861

CC @academicjobs

#Documentary #Docs #FilmStudies #Editing #Directing #Cinemastodon

ebassi, to GNOME
@ebassi@mastodon.social avatar

Finally added a page for the GTK inspector on the GNOME developers docs website: https://developer.gnome.org/documentation/tools/inspector.html

This way, I won't have to point people at the wiki any more.

hugovk, to writing
@hugovk@mastodon.social avatar

I've put together a little selection of tech style guides:

https://dev.to/hugovk/tech-style-guides-mg1

  • All
  • Subscribed
  • Moderated
  • Favorites
  • megavids
  • tacticalgear
  • magazineikmin
  • thenastyranch
  • Youngstown
  • mdbf
  • rosin
  • slotface
  • InstantRegret
  • khanakhh
  • Durango
  • kavyap
  • osvaldo12
  • DreamBathrooms
  • JUstTest
  • GTA5RPClips
  • ngwrru68w68
  • everett
  • tester
  • ethstaker
  • cisconetworking
  • cubers
  • modclub
  • provamag3
  • anitta
  • normalnudes
  • Leos
  • lostlight
  • All magazines