KDE Frameworks web page

[Harald Sitter]

On Tue, Dec 11, 2018 at 2:17 PM Alexander Potashev <aspotashev at gmail.com> wrote:
>
> Thanks!
>
> вт, 11 дек. 2018 г. в 15:32, Jonathan Riddell <jr at jriddell.org>:
> > > 2. Text on the blue grid under "Organisation" is not very readable.
> >
> > Works for me.  Again it's copying what's on the Kirigami page.  Suggestions welcome but the page needs some colour to break it up.
>
> I don't speak CSS, but placing this white text over its own
> text-shadow in blue (same dark blue as the background's primary color)
> could make it more readable as the grid won't interfere the letters
> anymore. (Sorry, it's just my guess, I didn't actually check how it
> would look.)
>
> > > 4. Can't find no direct link nor straightforward way to go to Git
> > > repos or download source tarballs. I think these must be easy to
> > > access, since KF5 is a developer-oriented product.
> >
> > I added 'download' to the release announcement link which seems to be
> > the best way to point the visitor to the newest release.
>
> https://download.kde.org/stable/frameworks/ could also work as a
> download link. Other products' announcements at
> https://www.kde.org/announcements/ may confuse newcomers.

Well, random tarballs aren't any more useful than mixed release
announcements TBH. Perhaps announcements.php could grow a filter by
Name feature so we can link to it and only get frameworks results? I
mean, even thinking about it makes me uneasy but I fear this is about
the best we could hope for until we actually move the website to
wordpress and can put announcements into categories. So, I think the
announcements link could maybe be refined a bit, but in general I
think this is where we should link.

> IMO the best
> would be a page with links to https://cgit.kde.org/... for each of the
> frameworks.

You mean like https://api.kde.org/frameworks/attica/html/index.html ;)

There's a link to the documentation under the Get Started section on
the frameworks page, it's where it should be and where people would
find it. It's not super helpful to utter newbies, but for the somewhat
proficient cpp and cmake user it's where all the relevant information
of a framework is and where I would go have a look for information on
how to use a framework. After all, release artifacts (e.g. source
tarballs) are only part of the story here, a small one even, the much
bigger part is how do I even use this cool frameworks stuff.

That said in general the is the larger issue here that needs dealing
with eventually (possibly not within the scope of what Jon is doing):
"I learned about frameworks, I think it's cool, I want to write an app
using frameworks. What do I do now?". The current api.kde.org is
kind-of the answer, but then it already assumes a lot of background
knowledge and examples are pretty much not existent either.

Anyway, I am rambling... announcement.php might need tweaks, otherwise
I think we are good. Helping interested third party devs use our
frameworks is something that needs figuring out though.

HS