News for hackers. Stuff that matters.

dragosbulugean

Show HN: Documentation.new – ship your product's docs v0 in one minute

https://documentation.new/

Shipping the first version of your docs is often the hardest part. We decided to fix that — meet documentation.newDescribe your product, upload readmes, faqs, or API references In under a minute, you’ll have a working outline to review and refine When you’re ready, hit Deploy — it spins up a live documentation site, ready to ship on your domain If you need to make changes and edits, continue...

( Read More... | no comments | 7 points | on HN )
hey @bamazizi, I think you are looking for archbee.com

we are cross the technical documentation spectrum solution, doing anything from end-user/dev API/guides to internal management of technical knowledge.

let me know if you'd like a demo, I'm the founder.

@kennywong1137 some curiosities :)

will there be a provisioning x amount of compute step for the customers?

or is it completely serverless offering for the customers?

if it's serverless how do you plan to manage the spikes on your own infra?

looks like a nice abstraction for distributed computing :)

where does it run?

Let's consider Visual Studio Code. It's OSS — still, I read the codebase a couple of times and I wouldn't venture into hacking into it — it's too large.

Being OSS enables hackability, it doesn't provide or guarantee it.

I've heard these arguments before and they sound good in theory, however in real life I haven't seen it work that way.

Projects dying off depends on developing a revenue stream or being backed by some company with a real revenue stream. Never solely about being open source. I have another comment about this when I talk about Lazarus below.

Being cross-platform sounds great in theory. However, most users don't use multiple OSes. Also, being cross-platform is extremely hard... for early-stage software you're better off making it work well on one platform, then extending when you achieve some traction with users. Being cross-platform with one tech also removes the chances of benefitting of platform specific APIs that might make it work better.

Lazarus, while I find it easy to get enthusiastic about, I'm old enough to have gone through a couple of cycles. The reason Electron with all its issues (memory consumption, app size) is winning is because there's a mass of developers that know how to build apps with HTML/JS/CSS. Like Haskell or OCaml or other awesome languages, if there's no mass of people that can contribute, the ecosystem never takes off — and ecosystem is the main trait of languages taking off. This is why an OSS project written in Lazarus using some relatively unknown UI APIs is unlikely to survive — I hope it does though.

Product Marketing Issue:

As a user of Hacker News, I don't care that it's open-source, cross-platform or written in Lazarus.

would love to hear why c++
Re:Quick Start Guide for Flipper Zero on Friday May 13, 2022 @04:55PM (#31372444)
congrats Flipper Zero team!
Re:Quick Start Guide for Flipper Zero on Friday May 13, 2022 @04:54PM (#31372438)
the team from flipper zero have put in a real effort into the docs.

P.S. docs are built with www.archbee.io

Re:The YC Winter 2022 Batch on Tuesday March 29, 2022 @11:51AM (#30844172)
the deadline is gone, but I also applied after the deadline and got in.

you should apply now!

Re:Show HN: EdgeDB 1.0 on Thursday February 10, 2022 @05:44PM (#30293799)
my thoughts exactly...

a graph database is not useful because of its query language, it's useful because of its performance characteristics when bringing linked data — it could never be performant on a Postgres backend.

does it work on a typical ES index, or do you have to re-index in a certain way for it to work?
Re:How to build a second brain as a software developer on Thursday November 11, 2021 @10:57AM (#29189343)
All the tools you mentioned are nice.

However, none are built for software developers. If you want to know why, ask yourself — does anything here make me feel special as a developer? My guess is the response is "No".

I'm the founder of archbee.io, and although it's an early stage product, I built it for engineers — and you can see that by the features: architecture diagrams, GitHub integration, markdown shortcuts, very speedy, API docs with GraphQL and OpenAPI, custom domain hosting, Mermaid diagrams and more.

Please check it out and let me know what you thought!

:)

Re:We deserve better than Confluence and Notion on Tuesday September 28, 2021 @01:57AM (#28679758)
Never ceases to amaze me how people are so quick to slap a "made for tech teams" onto their landing page — in an attempt to say they're for the entire company.

Exactly what is made for tech teams? All I see is generic features in there.

Confluence, Notion and Dokkument and all the tools are not made for tech teams. They are just generic editors and organizers. Notion stands out in the fact they are trying to cross boundaries from the docs space, into the project management space, and into the data management space.

Again, do we see API docs in any of these tools? Do we see integrations to GitHub, OpenAPI/Swagger, GraphQL, software architecture diagrams, changelogs, great markdown support? Do we see great care in keeping the software fast as required by tech people?

It didn't seem that way to me when I started building archbee.io — it's truly made for tech people.

Re:Ask HN: Why is Confluence Wiki Search so bad? on Monday September 20, 2021 @06:06PM (#28599630)
We're also trying to build something in the space with www.archbee.io, a YC company.
Archbee (YC S21) can help you in this regard. We provide you the CMS and the hosting platform for API and tech docs. On top of that it also works nicely for your internal team's usage. Please give it a try here: https://www.archbee.io
Toyota hybrids are really good imo.

It seems the car is much more complex, but it's not really. The electrical motor makes it possible to have a way less complex ICE engine, for many reasons. It's still an ICE car, but pollution & consumption is halfed.

There is a reason why Toyota Priuses (started building them 20yrs ago) and now Corollas are so reliable and cheap to maintain that you can find them in any cab.

Re:Open-source alternatives to popular B2B tools on Thursday July 22, 2021 @06:49AM (#27917415)
GitBook is not open source.
Re:Is GitHub Copilot a blessing, or a curse? on Tuesday July 20, 2021 @08:31AM (#27892949)
I like the idea, it's like a manual vs automatic clutch in cars. You are still the driver.
You should do it.

Even if you don't build a successful business/startup, you are going to learn so much that making the money again is going to be a piece of cake!

Hi Wojciech and Sylwia, congrats on the launch!

I followed the previous launches as well. I'm curious, what triggered the rebrand? Is there a story to it?

Re:Ask HN: Developer Portal Recommendations on Wednesday June 16, 2021 @02:31PM (#27531856)
hi, www.archbee.io is a hosted docs solution for your usecase.

disclaimer: I'm the founder, happy to show you around :)

Re:Fastly Outage on Tuesday June 08, 2021 @06:22AM (#27432858)
And all Webflow sites it seems...
Re:Fastly Outage on Tuesday June 08, 2021 @06:22AM (#27432854)
All Webflow sites?

Ask HN: What information do you consider knowledge in software development?

Hi, I am Dragos, the founder and sole developer of https://archbee.io - a tech team focused knowledge base & wiki.Right now our editor has plugins like: text, native diagrams, SwaggerUI, GraphiQL, changelogs, maps, callouts, APIs.What else could be used to express knowledge/documentation/know-how in software development teams?

( Read More... | no comments | on HN )

Older »