Giter Club home page Giter Club logo

graalvm-website's People

Contributors

fniephaus avatar gilles-duboscq avatar olyagpl avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

graalvm-website's Issues

Header covers headings on section links

When linking to a section in the documentation, the browser scrolls to the correct location, but the header covers the heading text. I haven't looked at the CSS, but I suspect the header is not being considered as part of the content area and as a result, is being rendered on top of the heading. Consequently, it's difficult to make use of such section links. While they should help direct a reader to a particular section, since the section heading is occluded, it makes the link less useful than directing a reader to the whole page.

As an example, the rendering of the JNI reflection docs looks like:

image

Whereas, it should look like:

image

[Homepage] Survey on the top: perhaps add some hint or indicator when this was added/created and for as long it is useful / in use

Hey folks,

At the homepage of GraalVM here:

https://www.graalvm.org/

You see a survey on the top. I also see a 'X' icon to click it away so no problem.

I believe I have already answered the survey some months ago, but I am not 100%
sure; and it may be another survey, after all.

My small suggestion here is to add an indicator WHEN this survey was added; and/or
for how long it will be up.

There are a few ways how to implement this. A simple one may be a tiny pop-up
with a "fade-in" effect on mouse-over effect, e. g. "This survey has been created
on the DATE_HERE and will run until FINAL_DATE_THERE." or something like
that. Of course there are other ways how to approach this, so the above is just
one simple example. If it were my homepage I'd add a e. g. 2 seconds delay
fade-in via mouse-on-hover to indicate the duration validity of the survey.

As it is right now, I assume I already answered the survey some months ago,
so I will click on the 'X' next; evidently if this is a newer survey then I may
never again visit it, as I do not know whether I already went through it or
not.

[Suggestion] One documentation to rule them all, and in the darkness ... \o/

I don't want to add unopened issues, so I'll make my case, then close it. If anyone else sees it
from the GraalVM / Oracle Team then this is great; if not then this is also fine.

Recently I looked at the docs for Java Swing at oracle:

https://docs.oracle.com/javase/tutorial/uiswing/

These are, I believe, a bit outdated, and I think they also no longer receive any updates.

Now here I was thinking ... what if all the API documentation about Java and the general
Java infrastructure, as far as GraalVM and Oracle and openjkd etc... is concerned, could
be bundled into ONE resource? I'd suggest GraalVM because the docs at GraalVM are
best. But the idea could be that slowly and steadily, documentation may be ported
over towards GraalVM. Perhaps with the help of more people, and if they make smaller
changes too (does not need to port EVERYTHING in a single day, could be all little
steps).

This would require, however had, a bit of coordination, kind of like a documentation-master,
whose task is to make the documentation in general great, starting from GraalVM (which
already has very good documentation).

Anyway. Perhaps my suggestion right now does not convince many, but who knows, in
a few years, perhaps documentation could be one super-strong focus over the whole
Java ecosystem. Right now information is a bit spread out all over the place, and it takes
quite some time to find all that is useful. This is why I think one central site would be
nice (oracle's homepage is a bit too static, which is why I think a team would require to
be able to move quickly and rapidly, to make changes, rather than a slow, long tedious
process that fatigues people out and away from contribution).

Where is the jshell-espresso demo?

Under the "Demo Applications/Mixing AOT for JIT and Java":

  1. Clone the project with the demo applications and navigate to the following directory: espresso/jshell

This project reference doesn't appear to exist anywhere in the document or on the web/github. The rest of the section discusses it. Is there a repository somewhere?

Site is harder to navigate now that all pages have the title "GraalVM"

A while ago (earlier in 2021), every documentation page included the individual page title in the <title> tag, making it easy to distinguish different pages when opened in several tabs. However, this appears to have regressed at some point (perhaps in 5cf1ce1), and now every page simply uses "GraalVM" in title.

Please restore the individual page title to the title tag for easier navigation. For example, https://www.graalvm.org/tools/ could use the link title "Debugging and Monitoring Tools" or perhaps include a suffix to denote the site, such as "Debugging and Monitoring Tools | GraalVM".

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.