-
m-relay
<rbrunner7:monero.social> Will have a look at Astro later today.
-
m-relay
<rbrunner7:monero.social> I remembered a detail not yet mentioned: With the system as it is today you can get immediate feedback on GitHub itself for a website PR in the form of a preview how the website will look with the PR applied. No idea how this works on a technical level. It's certainly nice for submitters, and especially for reviewers who can take a quick and uncomplicated look.
-
plowsof
We use netifly for that preview feature rbrunner, its great
-
plowsof
I dont even know the correct name of it if you are wondering about my technical knowledge.. netlify* :)
-
m-relay
<rbrunner7:monero.social> I know that well as a dev: If you have a solution for something that works well and works well for years, it's very easy to forget all its features because you take them for granted at this point, and you don't remember them right away if you want to compete with it with a brand-new solution. Can be quite slippery and often leads to underestimating the effort needed for the new solution.
-
m-relay
<rbrunner7:monero.social> As a boomer I can't help myself and have to link to this classic once again on this occasion:
joelonsoftware.com/2000/04/06/things-you-should-never-do-part-i
-
m-relay
<123bob123:matrix.org> github action?
-
m-relay
<rbrunner7:monero.social> Almost certainly, I would speculate. I just don't have any knowledge about the capabilities of those actions. Can you ask them to install a monster like NodeJS? Maybe, maybe not.
-
m-relay
<chch3003:monero.social> PR previews can be deployed on GitHub pages
github.com/marketplace/actions/deploy-pr-preview
-
plowsof
is basicswapdex opensource?
-
m-relay
<rbrunner7:monero.social> I had a quick look at Astro, just to get a first impression. Doesn't look to bad IMHO. In a sense it's typical of today's tools, throw everything in and to hell with complexity and size. But my gut feeling right now says that if we choose carefully exactly which feature sub-set we use for the Monero website, and how we use it, that tool might fly.
-
m-relay
<123bob123:matrix.org> Thing is most of them a java based
-
m-relay
<123bob123:matrix.org> are*
-
m-relay
<123bob123:matrix.org>
jamstack.org/generators
-
m-relay
<rbrunner7:monero.social> One important question about Astro though: What is the absolute minimum of software that must run on the production server that dishes out HTML to actual visitors?
-
m-relay
<rbrunner7:monero.social> A) Full Node.js plus full Astro on top
-
m-relay
<rbrunner7:monero.social> B) some trimmed down "runtime" with only parts of those two
-
m-relay
<rbrunner7:monero.social> C) nothing at all, because you can fully pre-render everything to HTML files and only put those on the production server
-
m-relay
<rbrunner7:monero.social> If only A) is possible that would make me pretty nervious because of security considerations, I must confess
-
m-relay
<chch3003:monero.social> You can serve only HTML, it's zero-JS by default, then you can do "progressive enhancement".
-
m-relay
<chch3003:monero.social> We can probably build locally and the server only have to serve.
-
m-relay
<chch3003:monero.social> You can serve only HTML, it's zero-JS by default, then you can do "progressive enhancement".
-
m-relay
<chch3003:monero.social> We can build locally and the server only have to serve.
-
m-relay
<rbrunner7:monero.social> So you speculate that C) might be possible? With no JavaScript interpreter needing to run on the webserver, because even a stupid Apache can of course serve pure HTML files that lie around in some folders?
-
m-relay
<chch3003:monero.social> Yes, I strongly speculate that, even tho I didn't try myself yet. This is what I understood from my research.
-
m-relay
<rbrunner7:monero.social> That would be attractive. I wonder however somewhat how you do multilanguage in such a scenario, and how the URLs will look.
-
m-relay
<chch3003:monero.social> It's true static site generation. With NextJS for example I think you can do it, but it's more ambiguous, even when they talk about SSG it's not true SSG. With Astro it is.
-
m-relay
<rbrunner7:monero.social> SSG meaning "server-side generation", right?
-
m-relay
<chch3003:monero.social> Static Site Generation
-
m-relay
<rbrunner7:monero.social> Ah, ok :)
-
m-relay
<rbrunner7:monero.social> How would the website switch between languages in such an absolutely-no-JavaScript-running-on-server scenario?
-
selsta
-
selsta
I'd prefer if we just select the language in a dropdown like our current website
-
selsta
I hate it when websites serve things in a different language based on my IP or some JS browser setting
-
m-relay
<rbrunner7:monero.social> Yeah, I strongly suspect that as soon as you read the word "routing" somewhere that's something that only Astro itself running on the server could do
-
m-relay
<chch3003:monero.social> We can't do otherwise without client-side JS anyway i think
-
m-relay
<rbrunner7:monero.social> That's a still unclear point then, seems to me.
-
m-relay
<chch3003:monero.social> Maybe for you hehe
-
m-relay
<chch3003:monero.social> The philosophy of Astro is really the same as Jekyll
-
m-relay
<chch3003:monero.social> It is made for Markdown content
-
m-relay
<chch3003:monero.social> The only difference is how we create UI
-
m-relay
<rbrunner7:monero.social> Well, not sure it's only my own problem. If I say absolutely no JavaScript anywhere tolerated, for security reasons, not in the Browser, nor on the server, is the problem still solvable?
-
m-relay
<chch3003:monero.social> I told you yes, we build locally
-
m-relay
<rbrunner7:monero.social> Does an English page and the corresponding German page have different URLs then?
-
m-relay
<chch3003:monero.social> The server pull from the repo and serve
-
selsta
"Does an English page and the corresponding German page have different URLs then?" <-- yes
-
m-relay
<chch3003:monero.social> I guess so
-
selsta
it would work like our current getmonero.org website
-
m-relay
<chch3003:monero.social> You can't even put the language in cookie without client-side js
-
m-relay
<rbrunner7:monero.social> Ah, yes, I see now. The German page does have a different URL.
-
m-relay
<rbrunner7:monero.social> I wasn't sure, but obviously this does not cause problems somewhere.
-
m-relay
<rbrunner7:monero.social> I mean, UI and UX problems for people who browse the website
-
m-relay
<chch3003:monero.social> So URL can be used to keep all kind of state
-
m-relay
<chch3003:monero.social> That's the only the state management we have
-
m-relay
<chch3003:monero.social> It's even better because you can share the exact page you want to share
-
m-relay
<rbrunner7:monero.social> Well, don't ask me the details, but languages work on getmonero.org in the Tor browser on the highest possible browsing security level.
-
m-relay
<chch3003:monero.social> It's in the URL no?
-
m-relay
<chch3003:monero.social> No magic here
-
selsta
Astro would work the same
-
m-relay
<rbrunner7:monero.social> I just saw, yes. The right URLs are already in the dropdown. No magic needed.
-
m-relay
<rbrunner7:monero.social> It's just links there in the "dropdown". I think I searched too far :)
-
m-relay
<rbrunner7:monero.social> Ok, you convinced me that we have a tool that merits a closer look as a candidate.
-
m-relay
<123bob123:matrix.org> Website meeting when?
-
m-relay
<chch3003:monero.social> And Astro is 38k stars on Github, it's the most popular true SSG
-
m-relay
<rbrunner7:monero.social> Yeah, and it has a very impressive number of contributors. Looks like true open source at first glance.
-
m-relay
<123bob123:matrix.org> Also reminds me of astro boy
-
m-relay
<chch3003:monero.social> Yes
-
m-relay
<rbrunner7:monero.social> NextJS looks downright "corporaty" in comparison, with their "enterprise offer" linked right from the frontpage
-
m-relay
<chch3003:monero.social> For sure, it is made by Vercel, you can super easily deploy there. Convinient but yeah more corporate
-
m-relay
<rbrunner7:monero.social> I think "true" open source gives good vibes with the Monero community
-
m-relay
<chch3003:monero.social> Something we didn't say is that, we can have a Astro website that works totally fine without JS, but also have JS for UI enhancement. It's not mandatory at all, I personally don't see why it would be a problem but just saying it's the whole progressive enhancement philosohy
-
m-relay
<chch3003:monero.social> We can have best of both worlds
-
selsta
I'd prefer no JS at all so that Tor and normal website are identical
-
m-relay
<rbrunner7:monero.social> Why not. Some nice animation how rings work in Monero for people bold enough to leave JavaScript on in their browser where people coming in over Tor without JavaScript get some static picture.
-
m-relay
<chch3003:monero.social> We can decide on that later
-
m-relay
<123bob123:matrix.org> We can also run miners in browser too when you visit
-
m-relay
<rbrunner7:monero.social> Lol
-
m-relay
<chch3003:monero.social> Reckless
-
m-relay
<123bob123:matrix.org> Maybe proof of concept with docs website
-
m-relay
<chch3003:monero.social> Is the doc website live now?
-
m-relay
<123bob123:matrix.org> Nope
-
m-relay
<123bob123:matrix.org> Soon™️
-
m-relay
<chch3003:monero.social> Is it based on Jekyll?
-
m-relay
<123bob123:matrix.org> There isnt one
-
m-relay
<chch3003:monero.social> Is it a new thing ?
-
m-relay
<chch3003:monero.social> Ha ok
-
m-relay
<rbrunner7:monero.social> Say again, where would those "docs" come from? Does something exist already in some form? I am a bit out out the loop here
-
m-relay
<chch3003:monero.social> Well for docs I have an other tool in mind haha
-
m-relay
<123bob123:matrix.org> Ment to be making an equivalent to monerodocs.org
-
m-relay
<123bob123:matrix.org>
github.com/monerodocs/md
-
m-relay
<123bob123:matrix.org> Mdbooks but its rust so plowsof no likey
-
m-relay
<plowsof:matrix.org> lol
-
m-relay
<123bob123:matrix.org> Plowsof will use wd40 on it or no rust
-
m-relay
<chch3003:monero.social> I like Antora for doc. It is based on AsciiDoc, similar to Markdown but better. Fully SSG also
-
m-relay
<chch3003:monero.social> I used it already
-
m-relay
<plowsof:matrix.org> moneroguides proposal was to keep the same setup / look / feel but adjust the 'available paths' a user can be taken to from each page IIRC
-
m-relay
<chch3003:monero.social> I can share what I made in private. Scared to dox myself here :/
-
m-relay
<plowsof:matrix.org> alternative monero-site implementation in rust
-
m-relay
<123bob123:matrix.org> Issue
-
m-relay
<123bob123:matrix.org> 1. Mkdoc search is js
-
m-relay
<plowsof:matrix.org>
monero-project/monero-site #2140 is hugo bad?
-
selsta
no, hugo is also good
-
m-relay
<123bob123:matrix.org> Luigi buffon needs to repo
-
m-relay
<123bob123:matrix.org> I know mdbook is markdown and rust
-
m-relay
<123bob123:matrix.org> Feels like mkdocs
-
m-relay
<chch3003:monero.social>
antora.org is the best
-
m-relay
<chch3003:monero.social> Research AsciiDoc if you don't know. Very similar to Markdown but you can do much more
-
m-relay
<chch3003:monero.social> Add LaTeX, footnotes, all kind of things
-
m-relay
<rbrunner7:monero.social> The most important thing about our docs is getting people to write them in the first place, and then even getting some other people to modify to keep them current. Compared with that *massive* problem every technical problem looks like peanuts ...
-
m-relay
<rbrunner7:monero.social> And I am pretty sure that if we have some nice site generator it will be able to generate what we would need for docs without breaking a sweat
-
m-relay
<123bob123:matrix.org> Meeting when ?
-
m-relay
<123bob123:matrix.org> Getmonero
-
m-relay
<123bob123:matrix.org> Docs
-
m-relay
<rbrunner7:monero.social> Can somebody ban this obnoxious Dan person already?
-
m-relay
<rbrunner7:monero.social> :)
-
m-relay
<123bob123:matrix.org> Meeting adjourned
-
m-relay
<chch3003:monero.social> This tool has been made for technical doc, is much better than Hugo or whatever for that purpose
-
m-relay
<rbrunner7:monero.social> Yes, I understand, but I think it is probably overkill for our use case. Write that damned doc already in some simple Markdown, game is won.
-
m-relay
<rbrunner7:monero.social> The problem is not missing footnote capability for docs, problem is almost nobody feels like writing docs :)
-
m-relay
<chch3003:monero.social> I don't want to have this debate again haha. But please have a look
-
m-relay
<123bob123:matrix.org> Unban ofrn and he will
-
m-relay
<123bob123:matrix.org> Need repo first
-
m-relay
<chch3003:monero.social> I let you all look a bit more into Astro and we take a decision?
-
m-relay
-
m-relay
<chch3003:monero.social> There are plenty of Youtube videos, articles..
-
m-relay
<123bob123:matrix.org> Google uses it
-
m-relay
<123bob123:matrix.org> Winrar
-
m-relay
<123bob123:matrix.org> For policies
-
m-relay
<chch3003:monero.social> Astro?
-
m-relay
<123bob123:matrix.org> Yeah
-
m-relay
<123bob123:matrix.org> Saw on the website
-
m-relay
<chch3003:monero.social> If Google uses it then..
-
m-relay
<chch3003:monero.social> ^^
-
m-relay
<123bob123:matrix.org> I think the prerequisite are
-
m-relay
<123bob123:matrix.org> 1. No js
-
m-relay
<123bob123:matrix.org> 2. Looks pretty
-
m-relay
<123bob123:matrix.org> 3. Multi language
-
m-relay
<123bob123:matrix.org> Cause if they are using github action it will use a shared runner, so an app without js is ideal
-
m-relay
<123bob123:matrix.org> Unless core self host a runner
-
m-relay
<chch3003:monero.social> You are saying that the GH Action server could be hacked? That would only be used for Preview eventually, not the final build
-
m-relay
<123bob123:matrix.org> Its a shared resource on github
-
m-relay
<chch3003:monero.social> Ok but it doesn't matter
-
selsta
we currently use netlify for previews
-
ofrnxmr
Lol, 3hrs ago i was pinged. Seriously, unban plowsof
-
ofrnxmr
135msgs missed is too many
-
m-relay
<123bob123:matrix.org> Nva