[fedora-websites] Issue #756: Idea for consideration: Redirect front page of fedoraprojecct.org to new overview docs
9:26 a.m.
mattdm reported a new issue against the project: `fedora-websites` that you are
following:
``
Right now, https://fedoraproject.org/ redirects to https://getfedora.org/. This was always
meant to be temporary until we could get Fedora Hubs up and going. I still expect
that's what we'll do, but in the meantime, the audience for getfedora.org — that
is, people looking to get the Fedora OS right now — isn't the same as for the project
website overall.
What if we redirect, instead, to the new Fedora Project Overview documentation? This is
waiting to be pushed to prod (really soon now!), but can be seen in staging at
https://docs.stg.fedoraproject.org/fedora-project/project/fedora-overview....
In summary:
**Redirect https://fedoraproject.org/ to
https://docs.stg.fedoraproject.org/fedora-project/project/fedora-overview... — what do
you think? **
(Everything else would remain as-is for now, although I think we probably also want to
redirect the code of conduct eventually.)
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
8:21 a.m.
New subject: [fedora-websites] Issue #756: Idea for consideration: Redirect front page of
fedoraproject.org to new overview docs
mattdm added a new comment to an issue you are following:
``
Update: docs are now live
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
8:29 a.m.
New subject: [fedora-websites] Issue #756: Idea for consideration: Redirect front page of
fedoraproject.org to new overview docs
duffy added a new comment to an issue you are following:
``
@mattdm if that redirect was set up as-is I think we'll have a lot of confusion about
which is the 'real' fedora website, and if one is meant to place the other.
I suggest changing the title on the docs docs one to say something like "Fedora
Project Community" instead of just "Fedora" so it was clear what it
specifically is.
The logo sizing on that page is out-of-proportion with the layout / text size, is there a
way to modify that?
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
6:10 a.m.
New subject: [fedora-websites] Issue #756: Idea for consideration: Redirect front page of
fedoraproject.org to new overview docs
mattdm added a new comment to an issue you are following:
``
@mattdm if that redirect was set up as-is I think we'll have a
lot of confusion about which is the 'real' fedora website, and if one is meant to
place the other.
I think we have that confusion already....
I suggest changing the title on the docs docs one to say something
like "Fedora Project Community" instead of just "Fedora" so it was
clear what it specifically is.
The HTML title, or the header, or something else?
The logo sizing on that page is out-of-proportion with the layout /
text size, is there a way to modify that?
Yes. See https://pagure.io/design/issue/552
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
7:36 a.m.
New subject: [fedora-websites] Issue #756: Idea for consideration: Redirect front page of
fedoraproject.org to new overview docs
duffy added a new comment to an issue you are following:
``
@mattdm that ticket says "though note that improvement to the overall look of the
docs site (including styles, fonts, etc.) are out of scope and a separate design
project." I don't understand. Does that mean the CSS can't be fixed?
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
7:41 a.m.
New subject: [fedora-websites] Issue #756: Idea for consideration: Redirect front page of
fedoraproject.org to new overview docs
mattdm added a new comment to an issue you are following:
``
We can adjust the CSS, but that's part of a bigger thing because it would affect all
of https://docs.fedoraproject.org/. I don't think we want to do per-document CSS.
But, we can adjust the _logo_ which is part of the document.
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
7:44 a.m.
New subject: [fedora-websites] Issue #756: Idea for consideration: Redirect front page of
fedoraproject.org to new overview docs
duffy added a new comment to an issue you are following:
``
What is generating docs.fedoraproject.org? It's not using Fedora bootstrap? Who
created this theme?
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
9:33 a.m.
New subject: [fedora-websites] Issue #756: Idea for consideration: Redirect front page of
fedoraproject.org to new overview docs
robyduck added a new comment to an issue you are following:
``
I have no strong opinion where fedoraproject.org should redirect to, but I think people
who went to fedoraproject.org were not looking for docs. The docs.fp.o will confuse people
more than getting redirected to getfedora.org. Also:
* I see docs.fp.o still a website with a lot of work in progress (links changed, CSS has
to be fixed, the website is only partially mobile-friendly, no responsive tags for images,
etc)
* Why should we redirect to a sort of overview with just Council links? Seems to me like
redirecting to a smaller wiki page. FInally, are users who are looking for Fedora,
searching informations about the Council?
Btw, can anyone tell me why the images on the docs pages have soooooooo long paths?
@duffy no, it seems it is using :
`<!-- Bootstrap -->
<link rel="stylesheet"
href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap....
<link rel="stylesheet"
href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap-...
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
9:38 a.m.
New subject: [fedora-websites] Issue #756: Idea for consideration: Redirect front page of
fedoraproject.org to new overview docs
mattdm added a new comment to an issue you are following:
``
I see docs.fp.o still a website with a lot of work in progress (links
changed, CSS has to be fixed, the website is only partially mobile-friendly, no responsive
tags for images, etc)
There's definitely room for improvement.
Why should we redirect to a sort of overview with just Council links?
Seems to me like redirecting to a smaller wiki page. FInally, are users who are looking
for Fedora, searching informations about the Council?
I'm not sure I understand. I'm suggesting redirecting to
https://docs.fedoraproject.org/fedora-project/project/fedora-overview.html. The Council
docs are findable on the left, but under a different section, starting with
https://docs.fedoraproject.org/fedora-project/council/charter.html
Btw, can anyone tell me why the images on the docs pages have
soooooooo long paths?
For whatever reason, asciibinder turns images into inline data. We'd have to ask the
asciibinder authors about that.
@duffy no, it seems it is using :
<!-- Bootstrap -->
<link rel="stylesheet"
href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap....
<link rel="stylesheet"
href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap-...
This comes from upstream asciibinder. I tried dropping in the Fedora bootstrap fork, but
it caused a lot of problems (images misaligned, the whole thing being undifferentiated
gray, etc.). @bex is talking to @ryanlerch about possibly using Fedora's bootstrap
instead of the upstream one, but there would need to be some tweaks.
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
3:01 p.m.
New subject: [fedora-websites] Issue #756: Idea for consideration: Redirect front page of
fedoraproject.org to new overview docs
jibecfed added a new comment to an issue you are following:
``
Can you please wait to have multi-language support for documentation?
While we can debate the getfedora landing is or isn't the best place to arrive (I have
no idea), at least non English speaker can understand something.
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
6:03 p.m.
New subject: [fedora-websites] Issue #756: Idea for consideration: Redirect front page of
fedoraproject.org to new overview docs
mattdm added a new comment to an issue you are following:
``
@jibecfed That's definitely worth taking into consideration. I think we could do
multi-language more quickly for just this one page rather than waiting for a full docs
solution, especially if we go with @duffy's suggestion of re-publishing the content in
a different format for the front page.
Right now, we have asciibinder to translate the asciidoc file into html for the docs site.
But we could just run asciidoctor directly (as `asciidoctor -s` to create "bare"
HTML which could be inserted into whatever workflow works for the websites team.
@bex , does that seem like a reasonable idea? We could simply add a
"translations" subdirectory to `council-docs/project/`, and then different
language subdirectories under there? Or we could even have a separate repo for translated
versions of this one document.
_Then_, when we get the full docs translation workflow up and going, we could regularize
this with that.
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
8:29 a.m.
New subject: [fedora-websites] Issue #756: Idea for consideration: Redirect front page of
fedoraproject.org to new overview docs
jibecfed added a new comment to an issue you are following:
``
I think we are close to have something that works fine for internationalization. The main
question is about how to handle _topic_map.yml . See
https://pad.lqdn.fr/p/fedora-docs-internationalization-jibecfed
Is there any rush not to wait for a few days/weeks?
We already have passed the moment where we have a working documentation system, for which
we had an agreement to focus on English only. By principle, I don't feel comfortable
about removing the few localized content we have.
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
7:24 a.m.
New subject: [fedora-websites] Issue #756: Idea for consideration: Redirect front page of
fedoraproject.org to new overview docs
bex added a new comment to an issue you are following:
``
@jibecfed That's definitely worth taking into consideration. I
think we could do multi-language more quickly for just this one page rather than waiting
for a full docs solution, especially if we go with @duffy's suggestion of
re-publishing the content in a different format for the front page.
Not sure I followed @duffy's solution here. Can someone rephrase it?
I am -1 for hacked multi-language as we are pretty close. I am cool with a deadline
though.
Right now, we have asciibinder to translate the asciidoc file into
html for the docs site. But we could just run asciidoctor directly (as asciidoctor -s to
create "bare" HTML which could be inserted into whatever workflow works for the
websites team.
@bex , does that seem like a reasonable idea? We could simply add a
"translations" subdirectory to council-docs/project/, and then different
language subdirectories under there? Or we could even have a separate repo for translated
versions of this one document.
Then, when we get the full docs translation workflow up and going, we could regularize
this with that.
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
12:41 p.m.
New subject: [fedora-websites] Issue #756: Use new overview adoc as source for mini-page
to go on front of https://fedoraproject.org
mattdm added a new comment to an issue you are following:
``
I updated the issue above with a new proposal.
I'm not sure where translation fits into this or how it interacts with docs.fpo
proposal — note that `_topic_map.yml` doesn't even come into it.
@jibecfed Note that I'm _not_ suggesting getting rid of getfedora.org at all. Just to
stop redirecting fedoraproject.org's top level to it. (I feel like it's really
confusing when the top page of a site redirects to a whole different site, but there's
still content under the first one — in this case, prominently, all the wiki content.)
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
12:41 p.m.
New subject: [fedora-websites] Issue #756: Use new overview adoc as source for mini-page
to go on front of https://fedoraproject.org
mattdm added a new comment to an issue you are following:
``
curl -s
https://pagure.io/Fedora-Council/council-docs/raw/master/f/project/fedora...
-
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
1:07 p.m.
New subject: [fedora-websites] Issue #756: Use new overview adoc as source for mini-page
to go on front of https://fedoraproject.org
bex added a new comment to an issue you are following:
``
I updated the issue above with a new proposal.
I'm not sure where translation fits into this or how it interacts with docs.fpo
proposal — note that _topic_map.yml doesn't even come into it.
The topic map has been a translation blocker. This may now be fixed.
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
1:08 p.m.
New subject: [fedora-websites] Issue #756: Use new overview adoc as source for mini-page
to go on front of https://fedoraproject.org
bex added a new comment to an issue you are following:
``
Does this mean your proposing just this page’s content be located on a separate site.
Then something like this in cron would keep it current?
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
1:20 p.m.
New subject: [fedora-websites] Issue #756: Use new overview adoc as source for mini-page
to go on front of https://fedoraproject.org
mattdm added a new comment to an issue you are following:
``
Does this mean your proposing just this page’s content be located on
a separate site. Then something like this in cron would keep it current?
Yeah, cron, or, as some kind of CI/CD pipeline. It'd take the adoc, run `asciidoctor
-s` (the `-s` suppresses the built-in header and footer) and put it in the middle of some
custom header and footer for the mini-site.
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
2:25 p.m.
New subject: [fedora-websites] Issue #756: Use new overview adoc as source for mini-page
to go on front of https://fedoraproject.org
jibecfed added a new comment to an issue you are following:
``
@jibecfed Note that I'm not suggesting getting rid of
getfedora.org at all. Just to stop redirecting fedoraproject.org's top level to it. (I
feel like it's really confusing when the top page of a site redirects to a whole
different site, but there's still content under the first one — in this case,
prominently, all the wiki content.)
I understand it and totally agree with you. I'll test yaml import tomorrow so we can
finish internationalization for docs.
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
4:32 p.m.
New subject: [fedora-websites] Issue #756: Use new overview adoc as source for mini-page
to go on front of https://fedoraproject.org
bex added a new comment to an issue you are following:
``
Does this mean your proposing just this page’s content be located on a separate site.
Then something like this in cron would keep it current?
Yeah, cron, or, as some kind of CI/CD pipeline. It'd take the adoc, run asciidoctor
-s (the -s suppresses the built-in header and footer) and put it in the middle of some
custom header and footer for the mini-site.
I am +1 this and willing to work with Web to determine the best place for it to live. It
sounds like it will need the translation toolset from docs but a hosting site like web. I
have some ideas ...
However, what we need to get going for realz is the header/footer from design.
``
To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/756
1427
days inactive
1449
days old
websites@lists.fedoraproject.org
19 comments
5 participants
participants (5)
-
Brian Exelbierd (bex) -
Jean-Baptiste Holcroft
-
Matthew Miller
-
Máirín Duffy
-
Robert Mayr