malarchelec, to defi French

🆘 Depuis février 2022, le service Archives et Ressources documentaires de Saint-Nazaire est malheureusement sans responsable...

Pourtant :

  • on a la mer🌊
  • une équipe top 🤝
  • des projets à porter et d'autres à inventer💡

Dit, Mastodon, tu ne connaitrais pas quelqu'un qui serait intéressé par tout ça ??

Les repouets sont plus qu'appréciés 👍

lambdageek, to vscode
@lambdageek@mastodon.social avatar

I've been doing some VS Code extension hacking recently (something cool coming soon, possibly!) and I have to say...

It is really a testament to LISP and to the Emacs contributors that docstrings are:

  1. a core part of the language
  2. are available on nearly every function and command

The best way to even find out if a command exists in VS Code is to open the "keyboard shortcuts" window. And then just guess the args…

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

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

hugovk,
@hugovk@mastodon.social avatar
phpdoc, to php
@phpdoc@phpc.social avatar

phpDocumentor 3.5 is here! With better Guides support and now fully functional RST! Automatic generated class diagrams by querying your code base and much more!

Let us know what you like in this new release!

https://github.com/phpDocumentor/phpDocumentor/releases/tag/v3.5.0

documentation, to php
@documentation@typo3.social avatar

📊 Some statistics at the end of the year

In 2023, a total of 1554 changes were applied to the , made by 79 contributors. 💪

Many thanks to everyone who contributed to keeping the documentation up to date and improving it. 🚀

See you next year. 👋

Lemmy, to random
@Lemmy@post.lurk.org avatar

I need a job!

My PhD is drawing to a close.

I'm looking for post-doc research opportunities or web/software development roles, ideally a combination, as in digital humanities research.

My previous research experience is in heritage and higher education for the arts.
My PhD was about knowledge frameworks and the affordances of digital tools and representations in research, in relation to research reuse, transparency and inclusivity.

I would love to be able to contribute more to innovative work on research and knowledge representations.

I am open to new possibilities! In particular I am interested in the possibility of becoming involved in sustainability and biodiversity-related research.

I am a full-stack web developer, and have a good deal of front-end design experience. I am open to all opportunities, particularly remote working!

I am not great at this self-promotion thing...
I will be putting a portfolio site online soon, but am happy to share a CV with anyone who is interested in the meantime.

Thanks for any boosts!














sebastian, to hardware
@sebastian@mastodon.cc avatar

you have an interesting or ?

please dont ask me to sign up to your or or such.
i won't.
i shouldn't have to.
i don't have time to hang around one channel per piece of tech in my household.

please write good . publish it on a static website. ask for help if you need help.
there is a reason good technology comes with good docs, not discord channels.

jaapio, to delhi Dutch
@jaapio@phpc.social avatar

On May 30, I will talk about dead , and how to bring your docs alive. Are you joining me and become Dr Frankenstein?

,

https://www.meetup.com/brabantphp/events/300465423/

libreoffice, to foss
@libreoffice@fosstodon.org avatar
cassidy, to linux
@cassidy@blaede.family avatar

Today's updated Flathub docs: more information for app developers about verification, including some more technical details. Inspired yet again by conversations with external ISVs.

https://docs.flathub.org/docs/for-app-authors/verification

thelastpsion, to retrocomputing
@thelastpsion@bitbang.social avatar

HIVE MIND: Can you give me some examples of good documentation websites? Or any doc websites about an entire computing platform.

I'm looking for examples on which to model the Project (https://doc.psion.info/). I want to give it a proper clean-up, formalise the structure somehow, and have some guidelines.

britter, to linux
@britter@chaos.social avatar

Can we please not have the word „simply“ in NixOS manual or nixos.wiki? NixOS learning curve is super steep and it‘s frustrating when you start and you don‘t understand how to do things that are supposed to be simple

rmoff, to random
@rmoff@data-folks.masto.host avatar

📖I've had @EvilDMP's https://diataxis.fr/ website about on my reading list for ages, and I'm so glad I finally got around to reading it.

⭐This stuff is pure gold! ⭐

The page on writing tutorials articulates the approach to take perfectly.

documentation, to php
@documentation@typo3.social avatar

@lina_wolf, @supergarv, @brotkrueml and Florian Thiele are currently on the Community Sprint in Düsseldorf. We are working on the new rendering based on the render-guides package from @phpdoc which should supersede the current Python-based rendering.

Edent, to opensource
@Edent@mastodon.social avatar

🆕 blog! “Discord is not Documentation”

I'm going to be slightly contrarian and say that I like Discord. It's great to be able to get real-time help on a problem. And it is fun to see, again in real-time, what other people are working on and struggling with. In truth, Discord is no harder to sign up to than Slack, Matrix, […]

👀 Read more: https://shkspr.mobi/blog/2023/07/discord-is-not-documentation/

ErHaWeb, to php German
@ErHaWeb@phpc.social avatar

Announcing new in version 1.3 of my EXT:klaro_consent_manager:
for Elements
enriched with
about this were added to the
https://docs.typo3.org/p/erhaweb/klaro-consent-manager/1.3/en-us/Introduction/Index.html

hazz223, to technology
@hazz223@mstdn.social avatar

I cannot express how important it is to write good, thorough, documentation for your projects.
How to build.
How to run.
Architecture.
Architecture decisions.
Runtime versions.

It will save you hours, days, and sometimes weeks having this written up. Your future self will love you (and maybe even toot about it).

ben, to fediverse
@ben@mastodon.bentasker.co.uk avatar

New : Adding a Fediverse Comments Box to a Site

This documentation details adding mastodon-post (by @DavidDarnes) into a static site generated by the Nikola in order to link back to discussion in the

https://www.bentasker.co.uk/posts/documentation/general/embedding-a-mastodon-comments-box-in-a-nikola-site-template.html

vdaron, to ShareYourMusic
@vdaron@mastodon.social avatar

Help Mastodon, I'm lost !

I'm looking for a alternative to Confluence to store my team documentation.

My short list today is
@dokuwiki
@xwikiorg
@ngpixel (Wiki.js) and
@MkDocs

What are you using ? What would you recommend ?

#wiki #collaboration #documentation #markdown

Boost would be appreciated. Thanks ! 🙂

jupiter, to dotnet
@jupiter@mastodon.gamedev.place avatar

(smol) JOB OFFER:

Fellow federated Technical Writers and Documentation Connoisseurs:

Where would I go to get someone to review my documentation for:

  • structure (didactic and otherwise)
  • accessibility
  • modernity
  • oversights

(also, if you have a friend or yourself to put forward for a consultation - I can likely spare adequate coin for your time, just send me your rate)

Topic is C# documentation for a game and simulation development library.

amoroso, to VintageOSes
@amoroso@fosstodon.org avatar

A young developer who never used Windows 98 back in the day stumbled upon an introductory book on the operating system and posted his impressions on skimming it, which brought him joy. He wrote:

"I was also left with the impression that perhaps I would like more software to come with a physical manual."

https://jamesg.blog/2024/05/19/windows-98-manual

#windows98 #documentation #retrocomputing

jani, to linux
@jani@fosstodon.org avatar

In case you want to reference a specific version of the Linux kernel documentation, you can use a URL with version, for example:

https://docs.kernel.org/6.8/

As described by @monsieuricon at https://lore.kernel.org/all/20240318-jumping-neon-vole-b02af3@lemur/

jaapio, to markdown Dutch
@jaapio@phpc.social avatar

I'm investigating options that are available to create a table of contents in #markdown, really wondering what people are using to create that when writing markdown based docs.

Please boost for reach.

#documentation

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