this post was submitted on 12 Sep 2023
983 points (97.8% liked)

Programmer Humor

18250 readers
1889 users here now

Welcome to Programmer Humor!

This is a place where you can post jokes, memes, humor, etc. related to programming!

For sharing awful code theres also Programming Horror.

Rules

founded 1 year ago
MODERATORS
 
top 50 comments
sorted by: hot top controversial new old
[–] [email protected] 139 points 9 months ago (4 children)

Whoever made Jira's markup syntax: Straight to jail.

[–] [email protected] 56 points 9 months ago (4 children)

The thing I dislike most about Atlassian products is that each of them has a completely different formatting engine and markup syntax. You'd think they'd be consistent but noooo

[–] [email protected] 22 points 9 months ago

Atlassian doesn't even have consistency within single products! I'm using Jira Cloud at work, and while most fields support markdown (e.g. three backticks to start a code block) there are a few that only support Jira's own notation (e.g. {code} to start a code block). It's always infuriating when I type some markdown in one of the fields that doesn't support it for some inexplicable reason.

[–] Potatos_are_not_friends 19 points 9 months ago (1 children)

In Confluence... the same emojis look different on page title on the sidebar vs the body. Two different font families.

It's incredible.

[–] sznio 5 points 9 months ago

Try to do any formatting more complex than none at all in Confluence. It just gets polluted with invisible markup and changes styling randomly.

[–] [email protected] 12 points 9 months ago

The thing I dislike about Atlassian is everything from Atlassian

[–] [email protected] 6 points 9 months ago (1 children)

Thankfully these days I spend most of my time in Confluence, which supports Markdown

[–] [email protected] 8 points 9 months ago* (last edited 9 months ago)

Both Bitbucket and Confluence partially support Markdown, but they implement it in different ways, which is maddening.

[–] [email protected] 36 points 9 months ago* (last edited 9 months ago)

Jira Developers: for the love of god can we PLEASE stop trying to shoehorn literally fucking everything into our platform?

Jira PMs: slaps roof this bad boy can fit so much scope creep

[–] brlemworld 17 points 9 months ago

Whoever made Jira~~'s markup syntax~~: Straight to jail.

[–] [email protected] 6 points 9 months ago

Same for Google Chat

[–] WorldieBoi 67 points 9 months ago (2 children)
[–] [email protected] 11 points 9 months ago (2 children)

I've been having trouble getting syntax highlighting to work on my '```' fenced code blocks. I give it the right/supported language identifier, but nothing changes.

I'm using neovim with a bunch of lsp plugins and treesitter. Anyone have dotfiles with markdown code syntax highlighting working?

[–] [email protected] 6 points 9 months ago* (last edited 9 months ago)

Are u using Mason and LSPconfig?

edit: Oh, I don't know that getting syntax highlighting in the blocks is something i've seen

load more comments (1 replies)
load more comments (1 replies)
[–] [email protected] 57 points 9 months ago (6 children)

Discovering obsidian has been a blessing for my sanity and made me less lazy for taking notes.

Plus I can use latex to transform md into docx and there's decent pdf support so I don't need to play with the circus of WYSIWYG pain that's MS Word.

[–] [email protected] 16 points 9 months ago* (last edited 9 months ago) (2 children)

I keep meaning to check out Obsidian, but I'm like you said, lazy.

[–] [email protected] 20 points 9 months ago (1 children)

Hi. This is your push to do it.
Download it and start a video tutorial of your choosing.
It's great! Do it!

load more comments (1 replies)
[–] [email protected] 11 points 9 months ago

Be lazier! I believe in you.

[–] FlexibleToast 13 points 9 months ago (1 children)

I have obsidian installed, but I haven't really looked into how to use it. It has been on my list of things I should probably learn for a long time now

[–] [email protected] 7 points 9 months ago (3 children)

I am probably just an idiot but i find writing proper notes with links etc very tedious, in obsidian.

So i end uo just typing everything into a few documents based on the doc title. Which means i might as well just use notepad

load more comments (3 replies)
[–] drislands 5 points 9 months ago (2 children)

Obsidian is what I used to keep my notes while playing Book of Hours. It was a fantastic tool and I'll definitely use it in the future!

load more comments (2 replies)
[–] IlIllIIIllIlIlIIlI 5 points 9 months ago (1 children)

Change Obsidian to Zettlr.

load more comments (1 replies)
load more comments (2 replies)
[–] [email protected] 52 points 9 months ago (2 children)

This is the way.

Almost completely pure way of storing ideas. With this I mean that you don't store unnecessary data such as "background should be white" or "left page margin is 1.3cm". It's just text. What's important is what it says + minimal markup.

Presentation is left to the reader's client. Do you want dark mode? Get a markdown editor/reader that supports it. Do you want serif font? Again, that's client's choice and not part of the document.

I wish browsers would support markdown out of the box, so you could open https://example.com/some-post.md

[–] [email protected] 42 points 9 months ago (1 children)

Old fart warning!

Presentation is left to the reader's client. Do you want dark mode? Get a markdown editor/reader that supports it. Do you want serif font? Again, that's client's choice and not part of the document.

I remember when that is how the web worked. All that markup was to define the structure of the document and the client rendered it as set by the user.

Some clients were better than others. My favourite was the default browser in OS/2 Warp, which allowed me to easily set the display characteristics of every tag. The end result was that every site looked (approximately) the same, which made browsing so much nicer, in my opinion.

Then someone decided that website creation should be part of the desktop publishing class (at least at the school I taught at). The world (wide web) has never recovered.

[–] ShortFuse 10 points 9 months ago (1 children)

We're kinda getting it back with the Accessibility tree

In theory, if the page is compiled right, you can read everything right from there. You could also interact with it.

[–] [email protected] 5 points 9 months ago (4 children)

Thanks. This is the first I've heard of the Accessibility tree. A quick look kind of spooked me, but I'll dig deeper.

load more comments (4 replies)
load more comments (1 replies)
[–] [email protected] 29 points 9 months ago* (last edited 9 months ago) (2 children)

Markdown is good. I use it when working in the company since the format is ubiquitous. I do writing my blog posts with Markdown (Hugo for the curious).

But personally, or working with a bit more niche team, for writing personal documentation I prefer Asciidoc [0]. It has better syntax and have some nice functionalities like Table of Contents.

For personal notes, nothing can surpass Org Mode [1].

[0] https://asciidoc.org

[1] https://orgmode.org

[–] [email protected] 5 points 9 months ago (1 children)

doesn't Markdown have a TOC function if you have at least 2 headings?

load more comments (1 replies)
load more comments (1 replies)
[–] NewPerspective 28 points 9 months ago (4 children)

Obsidian, md all the way down

[–] [email protected] 13 points 9 months ago (2 children)

Hot take: Obsidian is King right now of note taking and I'm all for it

[–] [email protected] 10 points 9 months ago

That's not a hot take. That's a damned gospel and I am singing baritone.

[–] NightAuthor 5 points 9 months ago

FOSS LogSeq or bust.

[–] [email protected] 6 points 9 months ago (2 children)

I want to like obsidian, but I find it to just be such a hideous UI. Any community themes cannot fix it. But to mention proprietary. I liked Logseq too, but it has the same problem just not as bad. People really need to not do custom UIs and should stick to native widgets with Material Me support.

load more comments (2 replies)
load more comments (2 replies)
[–] [email protected] 19 points 9 months ago (1 children)

I was looking for a journaling app that didn't have vendor locking, or required some weird export dump that messed your formatting and folders up. That lead me to Markdown and Obsidian. I love it. And when I die, that shit will still be readable by any basic text editor.

[–] NightAuthor 6 points 9 months ago (13 children)

LogSeq is similar, but FOSS

load more comments (13 replies)
[–] [email protected] 18 points 9 months ago (1 children)

Wait until you learn about Org-mode.

[–] [email protected] 11 points 9 months ago (3 children)

I’m vaguely aware of Org-mode but only as an alternative to Markdown. Last time I looked into it, though (years ago), Markdown seemed like a much better option for me for various reasons. Do you have a good argument for why Org-mode is a better choice for common use cases than the relatively universal GitHub-flavored Markdown?

[–] [email protected] 7 points 9 months ago

depending on what you do there are large benefits, for me they are executable code blocks (i.e. jupyter like experience) and way better latex support (if you type equations that are more involved this is rather important).

[–] [email protected] 5 points 9 months ago* (last edited 9 months ago) (2 children)

Much better ToDo list system with calendar integration and notifications via mobile apps.

load more comments (2 replies)
load more comments (1 replies)
[–] [email protected] 12 points 9 months ago

Could we convert this meme to markdown?

[–] [email protected] 11 points 9 months ago

Emacs gang here, coughing in org-mode.

[–] [email protected] 8 points 9 months ago (4 children)

Where is that footage from?

[–] Thade780 6 points 9 months ago

Parks and Recreation. Season 2, episode 5.

load more comments (2 replies)
[–] [email protected] 6 points 9 months ago

.md files on

[–] [email protected] 6 points 9 months ago
[–] Lizard 4 points 9 months ago (3 children)
[–] [email protected] 6 points 9 months ago
load more comments (2 replies)
load more comments
view more: next ›