from Hacker News

Alephic Writing Style Guide

by otoolep on 5/9/25, 2:25 PM with 46 comments

  • by skrebbel on 5/13/25, 8:25 AM

    I recognize that the following is a classic HN "middlebrow dismissal" but I'd be wary of taking writing advice from a company that has this text (and nothing else) on their homepage:

    > Alephic is an AI-first technology foundry built to tackle marketing's most complex challenges. We don't just advise—we engineer, prototype, and deploy custom AI systems that help marketing teams do the impossible.

    I read this twice and I still have no idea what they do!

  • by Barrin92 on 5/13/25, 8:06 AM

      Do                                  Don't
      Think from first principles         Repeat what everyone else is saying Draw from 
      diverse references and domains      Stay confined to marketing jargon
    
    "We paint visions of transformative change while keeping one foot firmly in practical reality."

    Famously non-jargon, non-marketing language never encountered before in a tech blog

  • by monicaaa on 5/22/25, 11:01 AM

    I used to spend hours stressing over how to meet all the detailed requirements of my assignments, especially when juggling multiple deadlines. What helped me was finding a service like https://paperap.com/government-essay-help/, where the writers understand academic expectations on a real, practical level. They’re all native English speakers, which makes a big difference in clarity and tone, and they adjust well to different academic styles depending on where you study. I’ve seen how helpful it can be when you’re stuck—especially with essays that feel too complex to tackle alone. It’s not just about getting a paper done fast, it’s about getting it done right, without adding more stress. For anyone feeling stuck, it might be worth considering as a backup plan that still lets you stay on track with your learning goals.
  • by ozornin on 5/13/25, 8:17 AM

    Another writing style guide, barely distinguishable from many others, but written in tone like it's radically different. Maybe this is precisely the point, though.
  • by brudgers on 5/12/25, 7:19 PM

    No space for poetry.

    No space for fun.

    All arguments from authority

    That only missionary position

    Is permissable.

  • by l5870uoo9y on 5/13/25, 10:48 AM

    Perhaps it should be clarified that this is a writing guide for marketing material and the formula is the same as always; concise sentences with a focus on action (readers almost always need to be pushed to click something, do something or buy something). If you write a blog, fiction or poetry, this writing guide will most likely crush any creativity, originality and desire to write.

    If you want to learn how to write well, your best bet is to read different great writers and notice how they write, what they write about and what they leave out. Take one of their sentences and rewrite it in your own words.Deconstruct every sentence. Deconstruct every sentence.Take their sentences and rewrite it in your own words.

  • by notepad0x90 on 5/13/25, 9:13 AM

    This is nice but they forgot to mention the most important rule all guides like this should mention first: There are no hard-and-fast rules, all rules have an exception.

    For example, including unnecessary sentences and paragraphs is somethings necessary. You can do without them but with them you get character, voice, a smoother transition. How do you know what is necessary and what isn't? That's the whole point of the rule I mentioned earlier.

  • by throwanem on 5/13/25, 8:02 AM

    Well, I'm sure it makes a decent system prompt.
  • by smartmic on 5/13/25, 10:18 AM

    I first thought this is from the German AI/LLM company Aleph Alpha [1] but learned it is a different enterprise albeit in the same domain. It's still quite a hustle and bustle in the zoo, I'm looking forward to a little more overview and a little less hype …

    [1] https://aleph-alpha.com/

  • by vanschelven on 5/13/25, 9:58 AM

    It's interesting to me that the article itself employs quite a few stylistic choices that are often marked as "obvious LLM tells" (numbered lists, boldface everywhere, and even the no-space emdash right in the opening paragraph).

    I'm a heavy user of those things myself... still: interesting, given what they seem to be doing.

  • by suddenlybananas on 5/13/25, 8:23 AM

    > Use "1800s/1900s/2000s" instead of "19th/20th/21st century". Using century numbers is confusing for many people because the 19th century actually refers to the 1800s. For clarity, always use the specific years.

    Way to assume your audience are morons.

  • by hellotimes on 5/13/25, 9:24 PM

    I’m still trying to grok this post from the same company

    https://www.alephic.com/the-one-true-path

  • by alienbaby on 5/13/25, 11:56 AM

    Writing like this leads to very terse, cold and impersonal communications. Perhaps it would be good for dry technical instructions or documentation, but naught else.
  • by ngangaga on 5/13/25, 12:04 PM

    This doesn't distract that you built a business around chatbots. Who gives a damn about the writing style you use to pimp them on us
  • by ritzaco on 5/13/25, 10:32 AM

    A lot of this is good and overlaps quite a bit with our one [0], but a lot of it seems to be too fluffy and go against its own rules.

    > At the intersection of AI, code, and marketing expertise, we create solutions that were impossible yesterday and will be commonplace tomorrow.

    I couldn't tell if this was an example of what they want or what they don't want.

    Also the dos and dont's are vague enough that I can imagine the CEO or whoever wrote this saying "no your sentence is bad because it's getting lost in the tacitcal minutiae, but mine is good because I'm focusing on strategic, long-term implications"

    - DO: Focus on strategic, long-term implications

    - DON'T: Get lost in tactical minutiae

    Similarly:

    - DO: Acknowledge the magnitude of AI's impact

    - DON'T: Overhype capabilities beyond what's currently possible

    isn't it easier to just say 'always use your crystal ball to perfectly explain how AI will affect our future'.

    > Utilize diagrams, screenshots, charts, and other visual aids to clarify complex concepts. For software documentation, use animated GIFs or videos when static images won't suffice.

    Probably means something like "Use diagrams, screenshots, and charts appropriately. Use animated gifs where needed"

    Which again is kind of just saying "make it good", but with words like "utilize" and "suffice" which are probably sprinkled in with AI.

    [0] https://styleguide.ritza.co

  • by fergie on 5/13/25, 11:53 AM

    There is a strong AI-smell from this page
  • by noahbrier on 5/10/25, 12:46 AM

    Thanks for the shout-out, glad you enjoyed it.