Skip to content

Home page first design mockup - #1048

Draft
nicos-arango wants to merge 6 commits into
mainfrom
main-page-mockup
Draft

Home page first design mockup#1048
nicos-arango wants to merge 6 commits into
mainfrom
main-page-mockup

Conversation

@nicos-arango

Copy link
Copy Markdown
Contributor

Description

Upstream PRs

  • 3.10:
  • 3.11:
  • 3.12:
  • 4.0:

@arangodb-docs-automation

Copy link
Copy Markdown
Contributor

Deploy Preview Available Via
https://deploy-preview-1048--docs-hugo.netlify.app

@cla-bot cla-bot Bot added the cla-signed label Jul 1, 2026
@coderabbitai

coderabbitai Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: bd0f7317-c14d-4efd-858e-f8933fccb20a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch main-page-mockup

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@nicos-arango nicos-arango reopened this Jul 2, 2026
@nicos-arango nicos-arango changed the title Main page mockup Home page first design mockup Jul 2, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This and a few other template files added again that break the example rendering!

@@ -0,0 +1,191 @@
{{ define "main" -}}
{{ $stable := "arangodb/stable/" -}}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not great. Can we move the content to a Markdown file and use the usual hardcoded 3.12 links that then get replaced dynamically with JavaScript to whatever ArangoDB version is/was last selected by the user?

Maybe this substitution can also work on theme files like this, I haven't ever tried. But <a> elements likely need the link class for that to get picked up.

{{ define "main" -}}
{{ $stable := "arangodb/stable/" -}}
<article class="home home-landing">
<style>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A lot of inline styles, but I suppose this is okay because it's limited to the one page - adding it to the theme.css or a separate .css file wouldn't make much sense.

Comment on lines +51 to +58
<h1>{{ .Title | markdownify }}</h1>
{{ with .Description }}<p class="home-lead">{{ . | markdownify }}</p>{{ end }}
<nav class="home-cta" aria-label="Primary shortcuts">
<a class="primary" href="{{ (print $stable "get-started/") | relURL }}"><i class="fas fa-rocket"></i>Get started</a>
<a href="#choose-path"><i class="fas fa-directions"></i>Choose your path</a>
<a href="#popular-tasks"><i class="fas fa-tasks"></i>Find a task</a>
<a href="{{ (print $stable "release-notes/") | relURL }}"><i class="fas fa-code-branch"></i>Release notes</a>
</nav>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess it's difficult to have this content in Markdown due to the use of elements and classes that can't easily/nicely be set in Markdown... Not great to have all this as HTML for later maintenance, although with Claude it should be fine.

<h2 id="quick-starts">Quick start guides</h2>
<p class="home-note">New to Arango? Pick a starting point and get to a working result fast. The full product manuals live in the sidebar on the left.</p>
<section class="home-grid cols-2">
<a class="qcard" href="{{ (print $stable "get-started/") | relURL }}">

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

None of the internal links here will be validated because that is only one in the render hook for Markdown links, which isn't ideal. Links in SVGs are also not checked. Maybe we can add an additional checker for these cases?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants