Let's start with the first iteration of devuan.org in the current layout that Hellekin and I put together for our first public release of Devuan Jessie 1.0 Beta. Hopefully, it will put the issues brought up above into historical perspective. Have a look here:

http://web.archive.org/web/201606041517 … evuan.org/

At that time I didn't even know what git was! I was entirely concerned with the content, colors and layout of the site. Hellekin dealt with the technical complexities of making it happen. It was quite a partnership! You can see that all the navigation links were dumped on the index page. Also note that dev1fanboy's docs were in a format detached from the website proper and sourced from his git repo. This is the historical reason that remains of dev1fanboy's "wiki" are present in the documentation section. It was not some over-arching structural decision for the www workflow which has ALWAYS been from www BETA to LIVE or MASTER or whatever it was called at the time.

When Hellekin moved on, I took over www and eventually all public-facing web content went through me, even dev1fanboy's and fsmithred's and the docs that rrq and I crafted for the install disk(s). I had a LOT of catching up to do but eventually managed to gain enough git pointy-clicky proficiency to accomplish all the public-facing upgrades to ascii and beowulf documentation as needed.

I also redesigned the site over the years to have a proper nav bar and trimmed content down to the minimal needed. Mostly it consisted of rearranging/compacting/rewriting and eliminating redundancies of information already available. Please do take a tour on web.archive.org to see how the site morphed over the years.

Then I just burned out - partly due to age; partly due to the enormous workload - and Xenguy stepped up to take over www beginning with Chimaera (though I still provided the matching default colors).

I should have thought to write this brief history of www earlier but now that the issue came up, I finally mustered the focus to put things into historical perspective. I do hope that it helps to clarify how we got to where we are.

Any questions? Start a new thread.

golinux wrote:

@tomasz . . .  What we choose with each intentional action sets the course of our life. Easy to shoot oneself in the foot so best to choose wisely . . .

Hard to disagree. But the filter situation also means that if I have something to share with you, it will be published on Debian's Salsa.

Some things are not meant to be . . .

@tomasz . . .  What we choose with each intentional action sets the course of our life. Easy to shoot oneself in the foot so best to choose wisely . . .

Hard to disagree. But the filter situation also means that if I have something to share with you, it will be published on Debian's Salsa.

Not sure if I should open an issue for your trouble logging into git web interface. @tomasz

Thanks. That's nice. That is not a bug, but a feature. Thanks to the spammer filter. I disregard that filter. And this translates into me being banished.

And https://git.devuan.org/devuan/documenta … himaera.md

I will add this to the issue along with all your other recommendations.

Not sure if I should open an issue for your trouble logging into git web interface. @tomasz

.
├── bin
├── data
├── etc
│   └── nginx
│       ├── sites-available
│       └── snippets
├── lib
├── locales
└── source
    ├── error
    ├── os
    │   ├── announce
    │   │   └── report

start

    │   └── documentation
    │       ├── design-guide
    │       ├── dev1fanboy
    │       │   ├── en
    │       │   ├── es
    │       │   ├── img
    │       │   └── it
    │       └── install-guides
    │           ├── ascii
    │           │   └── img
    │           │       └── live-gui
    │           ├── beowulf
    │           │   └── img
    │           │       └── live-gui
    │           └── chimaera
    │               ├── css
    │               ├── img
    │               │   └── live-gui
    │               └── pics

end

    └── ui
        ├── css
        │   ├── debbugs
        │   ├── fonts
        │   └── pkginfo
        └── img
            └── 404

@auanta . . . Have you actually looked at the website? The Explore page in the navbar lists all the documentation included in the website and some links point to resources elsewhere.

There is also a lot of practical documentation on this very forum as well as the DNG mail list.

Yeah, I've spent 2 days on this now (many hours) and looked through all of it including the git repo. Why do you ask?

Let me be clear, I'm aware that the documentation is presented on the website, but when I choose the language of separating them it is because I know behind the server, documentation and web dev are different skillsets. Yes, the end result is they both show up on the website.

And the actual live website, I am speaking about this separately from the git repos. Yes, what I am saying is there is an inconsistency between the live site and the repos. My not finding documentations within the www repo is because the documentation lives in its own "documentation" repo, not the www repo as far as I see when I look at the files.

There is also a lot of practical documentation on this very forum as well as the DNG mail list.

auanta wrote:

tomasz wrote:

No. There are two. Why otherwise would you report a bug on one of them mentioning the other?

I mean, in theory there could be two repos, but then where is the second repo? In my bug report I reference the live site at devuan.org and the repo at git.devuan.org but no secondary repo.

https://git.devuan.org/devuan/www.devuan.org/ is secondary.

OK, gotcha, well but that's the website and they put the documentation in a separate repo, which honestly makes sense, to keep the web development and documentation separate. There apparently needs to be more (automated) synchronicity however.

It would be more beautiful if it was devuan/www.devuan.org/documentation but none of the git repos seem to go deeper than 1 level. I mean, you can't have a repo in a repo.

Just how it appears to me. I dug around and can't find any documentations within the www repo.

tomasz wrote:

auanta wrote:

I'm searching up and down, and only see one documentation repo. So I think we're ok on that.

No. There are two. Why otherwise would you report a bug on one of them mentioning the other?

I mean, in theory there could be two repos, but then where is the second repo? In my bug report I reference the live site at devuan.org and the repo at git.devuan.org but no secondary repo.

https://git.devuan.org/devuan/www.devuan.org/ is secondary.

auanta wrote:

I'm searching up and down, and only see one documentation repo. So I think we're ok on that.

No. There are two. Why otherwise would you report a bug on one of them mentioning the other?

I mean, in theory there could be two repos, but then where is the second repo? In my bug report I reference the live site at devuan.org and the repo at git.devuan.org but no secondary repo.

I'm searching up and down, and only see one documentation repo. So I think we're ok on that.

No. There are two. Why otherwise would you report a bug on one of them mentioning the other?