HNHacker News
TopNewBestAskShowJobs

marcpaq

118 karma · joined September 21, 2016

I'm a technical writer with lots of experience documenting big complex systems for demanding technical and non-technical users.

And I have blogs:

https://egopontem.com https://purserclub.com

submissionscomments
marcpaq··on Alberta startup sells no-tech tractors for half price
Indeed, my boat has a Yanmar diesel engine from the 1980s. Except for the electrical needs of the starter motor, alternator, and a couple of alarm sensors, Yanmar and other makers of this vintage purposely made these engines to run entirely mechanically.

There are no digital controllers and no consequent promises of higher efficiency or reliability. More than one sailor I've talked to see this absence of electronics as a feature. Sailors are wary of gear that's difficult to understand.

With just a half-decent socket wrench set and a few other common tools, my delicate desk-job hands handle all maintenance tasks and most repairs.

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (May 2025)
SEEKING WORK | Remote | Contract

Hi! Do you need engaging, useful technical content?

That amazing thing you're building—I can show people how to use it. I'm a tech writer with extensive experience in engaging demanding technical and non-technical users with relevant, accurate content. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Current and past deliverables: Developer advocacy, technical blogging, white papers, ghost writing, user documentation, API/SDK, S&RED.

Subjects: AI, SaaS platforms, software development, healthcare, fintech, open source software.

More info:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (April 2025)
SEEKING WORK | Remote | Contract

Hi! Do you need engaging, useful technical content?

That amazing thing you're building—I can show people how to use it. I'm a tech writer with extensive experience in engaging demanding technical and non-technical users with relevant, accurate content. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Current and past deliverables: Developer advocacy, technical blogging, white papers, ghost writing, user documentation, API/SDK.

Subjects: AI, SaaS platforms, software development, healthcare, fintech, open source software.

More info:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (March 2025)
SEEKING WORK | Remote | Contract

Hi! Do you need engaging, useful technical content?

That amazing thing you're building—I can show people how to use it. I'm a tech writer with extensive experience in engaging demanding technical and non-technical users with relevant, accurate content. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Current and past deliverables: Developer advocacy, technical blogging, white papers, ghost writing, user documentation, API/SDK.

Subjects: AI, SaaS platforms, software development, healthcare, fintech, open source software.

More info:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (February 2025)
SEEKING WORK | Remote | Contract

Hi! Do you need engaging, useful technical content?

That amazing thing you're building—I can show people how to use it. I'm a tech writer with extensive experience in engaging demanding technical and non-technical users with relevant, accurate content. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Current and past deliverables: Developer advocacy, technical blogging, white papers, ghost writing, user documentation.

Subjects: AI, SaaS platforms, software development, healthcare, fintech, open source software.

More info:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (January 2025)
SEEKING WORK | Remote, happy to travel | Contract

Hi! Do you need engaging, useful technical content?

That amazing thing you're building—I can show people how to use it. I'm a tech writer with extensive experience in engaging demanding technical and non-technical users with relevant, accurate content. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Current and past deliverables: Developer advocacy, technical blogging, white papers, ghost writing, user documentation.

Subjects: AI, SaaS platforms, software development, healthcare, fintech, open source software.

More info:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (December 2024)
SEEKING WORK | Remote | Contract

Hi! Do you need engaging, useful technical content?

That amazing thing you're building—I can show people how to use it. I'm a tech writer with extensive experience in engaging demanding technical and non-technical users with relevant, accurate content. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Current and past deliverables: Developer advocacy, technical blogging, white papers, ghost writing, user documentation.

Subjects: AI & machine learning, SaaS platforms, software development, healthcare workflow, fintech, open source software.

More info:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (November 2024)
SEEKING WORK | Remote | Contract

Hi! Do you need engaging, useful technical content?

That amazing thing you're building—I can show people how to use it. I'm a tech writer with extensive experience in engaging demanding technical and non-technical users with relevant, accurate content. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Current and past deliverables: Developer advocacy, technical blogging, white papers, ghost writing, user documentation.

Subjects: SaaS platforms, software development, healthcare workflow, fintech, machine learning, open source software.

More info:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (October 2024)
SEEKING WORK | Remote | Contract

Hi! Do you need engaging, useful technical content?

That amazing thing you're building--I can show people how to use it. I'm a tech writer with extensive experience in engaging demanding technical and non-technical users with relevant, accurate content. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Current and past deliverables: Developer advocacy, technical blogging, white papers, ghost writing, user documentation. Subjects: SaaS platforms, software development, healthcare workflow, fintech, machine learning, open source software.

More info:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (September 2024)
FREELANCE, Remote

Hi! Do you need engaging, useful technical content?

That amazing thing you're building--I can show people how to use it. I'm a tech writer with extensive experience in engaging demanding technical and non-technical users with relevant, accurate content. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Current and past projects: Developer advocacy, technical blogging, ghost writing, and user documentation for SaaS platforms, embedded software development tools, healthcare workflow, machine learning, and open source software.

More info:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (July 2024)
FREELANCE, Remote

Hi! Do you need engaging, useful technical content?

That amazing thing you're building--I can show people how to use it. I'm a tech writer with extensive experience in engaging demanding technical and non-technical users with relevant, accurate content. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Current and past projects: Developer advocacy, technical blogging, ghost writing, and user documentation for SaaS platforms, embedded software development tools, healthcare workflow, machine learning, and open source software.

More info:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: How to handle user file uploads?
Have you considered a commercial solution?

https://developer.massive.io/js-uploader/

Just point it to your local files, as big as you want, and it does the rest. It handles the complexities of S3 juggling and browser constraints. Your users pay nothing to upload, you pay for egress.

Full disclosure: I'm MASV's developer advocate.

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (May 2024)
SEEKING WORK, Remote

Hi! Do you need engaging, useful technical content?

That amazing thing you're building--I can show people how to use it. I'm a tech writer with extensive experience in engaging demanding technical and non-technical users with relevant, accurate content. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Recent and past projects: Developer advocacy, technical blogging, ghost writing, and user documentation for SaaS platforms, embedded software development tools, healthcare workflow, machine learning, and open source software.

More info:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (April 2024)
Hi! Do you need engaging, useful technical content?

That amazing thing you're building--I can show people how to use it. I'm a tech writer with extensive experience in engaging demanding technical and non-technical users with relevant, accurate content. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Recent projects: Developer advocacy, technical blogging, ghost writing, and user documentation for SaaS platforms, embedded software development tools, distributed radiology workflow systems, machine learning, and open source software.

More info:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on (How to Write a (Lisp) Interpreter (In Python)) (2010)
If you mean "Lisp" interpreter, then I also did something that's kinda what you're describing:

https://github.com/marcpaq/arpilisp

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (March 2024)
SEEKING WORK | Montreal, Remote | Technical writer, freelance

Hi! Do you need engaging, useful technical content?

That amazing thing you're building--I can show people how to use it. I'm a tech writer with extensive experience in documenting complex systems for demanding technical and non-technical users. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Recent projects: Technical blogging, ghost writing, and user documentation for SaaS platforms, embedded software development tools, distributed radiology workflow systems, machine learning, and open source software.

More info:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (February 2024)
SEEKING WORK | Montreal, Remote | Technical writer, freelance

Hi! Do you need engaging, useful technical content?

That amazing thing you're building--I can show people how to use it. I'm a tech writer with extensive experience in documenting complex systems for demanding technical and non-technical users. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Recent projects: Technical blogging, ghost writing, and user documentation for SaaS platforms, embedded software development tools, distributed radiology workflow systems, machine learning, and open source software.

More info:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (January 2024)
SEEKING WORK | Montreal, Remote | Technical writer, freelance

Hi! Do you need engaging, useful technical content but not a full-time tech writer?

That amazing thing you're building--I can show people how to use it. I'm a tech writer with extensive experience in documenting complex systems for demanding technical and non-technical users. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Recent projects: Technical blogging, ghost writing, and user documentation for SaaS platforms, embedded software development tools, distributed radiology workflow systems, machine learning, and open source software.

My experience:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Thomas Cochrane
O'Brian & Forester wrote fun adventures in the golden age of sailing.

You can look a little further still to check out Dudley Pope's Ramage series.

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (December 2023)
SEEKING WORK | Remote | Technical writer, freelance

Hi! Do you need engaging, useful technical content but not a full-time tech writer?

That amazing thing you're building--I can show people how to use it. I'm a tech writer with extensive experience in documenting complex systems for demanding technical and non-technical users. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Recent projects: Technical blogging, ghost writing, and user documentation for SaaS platforms, embedded software development tools, distributed radiology workflow systems, machine learning, and open source software.

My experience:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (November 2023)
SEEKING WORK | Remote | Technical writer, freelance

Hi! Do you need engaging, useful technical content but not a full-time tech writer?

That amazing thing you're building--I can show people how to use it. I'm a tech writer with extensive experience in documenting complex systems for demanding technical and non-technical users. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Past projects: Technical blogging, ghost writing, and user documentation for SaaS platforms, embedded software development tools, distributed radiology workflow systems, machine learning, and open source software.

My experience and projects:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (October 2023)
SEEKING WORK | Remote | Technical writer, freelance

Hi! Do you need engaging, useful technical content but not a full-time tech writer?

I can show people how to use the amazing new thing you're building. I'm a tech writer with extensive experience in documenting complex systems for demanding technical and non-technical users. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Past projects: Technical blogging, ghost writing, and user documentation for SaaS platforms, embedded software development tools, distributed radiology workflow systems, machine learning, and open source software.

My experience and projects:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (September 2023)
SEEKING WORK | Remote | Technical writer

Hi! You're building something amazing and I can show people how to use it.

I'm a technical writer who helps growing companies build engaging, useful technical content. I have extensive experience in documenting complex systems for demanding technical and non-technical users. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Past projects: Technical blogging and user documentation for SaaS platforms, embedded software development tools, distributed radiology workflow systems, machine learning, and open source software.

My experience and projects:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (August 2023)
SEEKING WORK | Remote | Technical writer

Hi! You're building something amazing and I can show people how to use it.

I'm a technical writer who helps growing companies build engaging, useful technical content. I have extensive experience in documenting complex systems for demanding technical and non-technical users. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Past projects: Technical blogging and user documentation for SaaS platforms, embedded software development tools, distributed radiology workflow systems, machine learning, and open source software.

My experience and projects:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on My Problem with the Four-Document Model
Good article.

Tech writer for too many years here:

I agree with the 4 doc model. It boosts a proven structure for individual pieces of a doc set.

DITA formalizes this with its topic, concept, and task, and reference topics. You see another form of it in man pages.

And I agree with the FTA, it's often overkill or just plain unsuitable.

If you're stuck with writing anything from a readme to an aircraft maintenance library, then you can make your content engaging and useful by just making sure that it's correct, clear, concise, consistent, and cohesive. Above all it should be compassionate[1].

Check off those 7 C's and your doc will be appreciated. The 4 doc model is just one option to get you there.

[1] https://egopontem.com/blog/7cs

marcpaq··on Ask HN: Could you share your personal blog here?
https://egopontem.com

Thoughts on tech writing and related things.

https://purserclub.com

Sharing what I've learned while maintaining my sailboat.

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (July 2023)
SEEKING WORK | Remote | Technical writer

Hi! You're building something amazing and I can show people how to use it.

I'm a technical writer who helps growing companies build engaging, useful technical content. I have extensive experience in documenting complex systems for demanding technical and non-technical users. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Past projects: Technical blogging and user documentation for SaaS platforms, embedded software development tools, distributed radiology workflow systems, machine learning, and open source software.

My experience and projects:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (June 2023)
SEEKING WORK | Montreal | Remote | Technical writer

Hi! You're building something amazing and I can show people how to use it.

I'm a technical writer who helps growing companies build engaging, useful technical content. I have extensive experience in documenting complex systems for demanding technical and non-technical users. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Past projects: Technical blogging and user documentation for embedded software development tools, distributed radiology workflow systems, machine learning platforms, cloud storage, and open source software.

My experience and projects:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

marcpaq··on Build Your Own Lisp
Agreed. BYOL and MAL are excellent work.

I had fun making an interpreter in ARM assembly:

https://github.com/marcpaq/arpilisp

Since the world obviously needs another book on Lisp-making, I'm thinking of porting it to arm64 and expanding it into a book.

marcpaq··on Ask HN: Freelancer? Seeking freelancer? (May 2023)
SEEKING WORK | Montreal | Remote | Technical writer

Hi! You're building something amazing and I can show people how to use it.

I'm a technical writer who helps growing companies build engaging, useful technical content. I have extensive experience in documenting complex systems for demanding technical and non-technical users. And I've helped documentation teams to write more and fuss less by implementing process improvements and automation.

Past projects: Technical blogging and user documentation for embedded software development tools, distributed radiology workflow systems, machine learning platforms, cloud storage, and open source software.

My experience and projects:

https://egopontem.com

https://github.com/marcpaq

https://www.linkedin.com/in/marcpaq/

Let me know if you're interested in starting your technical content on the right foot: marcpaq@egopontem.com

Page 1 of 2Next →