migrate documentation

[frank-bg]

Hi, thanks for the great work on the project!

Is there any plan to migrate the documentation to a new place? The current documentation is hosted on Laravel's documentation site, but it seems like it would be better to have it hosted on the project's own site (if any).

How can I contribute to this effort? I would be happy to help with the migration process or provide any assistance needed.

[svpernova09]

If this is something you (or anyone else) would be interested in doing, I'd be happy to create a new repo just for homestead docs as long as we use a recent/modern static site generator. The laravel docs use (or used) VuePress?

[coolamit]

Github pages? Doc files can be stored as markdown & Github auto builds them to HTML.

[frank-bg]

The laravel docs use (or used) VuePress?

I couldn't find how the laravel docs work.

the repo only contains .md files: https://github.com/laravel/docs

Github pages? Doc files can be stored as markdown & Github auto builds them to HTML.

I was thinking more like readthedocs, but I am open to proposal

[svpernova09]

5 years ago, I did this: https://github.com/svpernova09/homestead-docs and never really stuck with it. This was also before we archived Laravel/Homestead.

We can either use GitHub Pages, or I can wire up hosting on my existing infrastructure.

I'd like to avoid using Jekyll for this, as I found Vuepress and other non-Ruby static site generators to be more debug-friendly.

[coolamit]

Github pages? Doc files can be stored as markdown & Github auto builds them to HTML.

I was thinking more like readthedocs, but I am open to proposal

Free for open source projects but it shows ads. :)

Also I don't think there's a need to depend on a SaaS like that, at present.

[coolamit]

We can either use GitHub Pages, or I can wire up hosting on my existing infrastructure.

I'd like to avoid using Jekyll for this, as I found Vuepress and other non-Ruby static site generators to be more debug-friendly.

I'm ok with either here. The docs will be in markdown in a Git repo, easy to maintain & all. Then what site generator is used isn't much of an issue since it can be changed without worrying about any data migration etc.

VuePress creates SPAs using Vue? You sure you want to do that instead of plain old HTML for this? Just asking because I'm not leaning on any side here.

[svpernova09]

We can either use GitHub Pages, or I can wire up hosting on my existing infrastructure.
I'd like to avoid using Jekyll for this, as I found Vuepress and other non-Ruby static site generators to be more debug-friendly.

I'm ok with either here. The docs will be in markdown in a Git repo, easy to maintain & all. Then what site generator is used isn't much of an issue since it can be changed without worrying about any data migration etc.

VuePress creates SPAs using Vue? You sure you want to do that instead of plain old HTML for this? Just asking because I'm not leaning on any side here.

I would be perfectly happy with static HTML and leaving JS out of it.