ovirt / ovirt-site Goto Github PK

It should be similar to what's on ManageIQ.org and RDOproject.org.

Many pages use code blocks. This issue addresses the need to review and optimize each code block. Optimized code blocks are indented starting at the flush left, surrounded by three backticks and, optionally, the programming language (which would cause the code block to be syntax highlighted)... instead of just merely being indented.

See http://kramdown.gettalong.org/syntax.html#code-blocks for more information.

Please note that we do not use the fenced code block style as in the Kramdown documentation, but use GitHub-style fenced code blocks (that is, backticks '`' instead of tildes '~').

See https://help.github.com/articles/github-flavored-markdown/#fenced-code-blocks

(Note: We basically use GitHub style Markdown with a bit of Kramdown enhancements on top. This is so we can preview most everything on GitHub directly and still can use classes and such with {:.classnameone.classnametwo} type Kramdown extensions.)

Currently we have a "community guidelines" topic that lists in general terms the guidelines to follow when operating within the community. However, the topic describes conduct guidelines only in broad terms, and also contains sections related to naming conventions etc, that don't really belong there.

Link to original topic:
https://github.com/oVirt/ovirt-site/blob/master/source/community/about/community-guidelines.html.md

Need to break down the topic to conduct vs infra vs ops, and formalize each type of information into its own topic.

The Blog tab should link to a page that contains the "archives" of the blog posts (same page that is accessible when you click "more news" from the Home page).

After the reorg, the top navbar should read:

Home
Blog
Download
Documentation
Develop
Community
Search

So on the new website, it seems that the link to the privacy policy is missing and give a 404.

Since a 404 triggers a search of pages, it's probably useful to add the search fragments to the search index.

In most cases, the page bubbles to the top anyway, but in a few somewhat rare instances, the terms are only used in the URL and not in the page, making the 404 search show no results. Adding the fragments to the index, both for the original page as well as a wiki title (if applicable), would ensure the page would show up in these cases.

at http://beta-ovirtweb.rhcloud.com/community/

oVirt is always looking for talented contributors. Red Hat may be able to hire some of them. Please add a "Jobs" tab to the main page, where we can list the descriptions of Linux-savvy Python and enterprise Java developers that we are looking for.

In the new architecture page (http://www.ovirt.org/documentation/architecture/architecture/), overall architecture picture shows that engine supports active-active high availability.

According to Yaniv Kaul(ykaul at redhat.com) in mailing list,

This is inaccurate - the engine is not highly available in A/A
architecture. I'd appreciate if you could file an issue for it so we'll fix
this page.

(copy-paste from https://bugzilla.redhat.com/show_bug.cgi?id=1315120 )

In the old wiki you have some html anchors to link page sections, and some intra-page links for the are now broken

http://beta-ovirtweb.rhcloud.com/community/
there's a link to http://beta-ovirtweb.rhcloud.com/community/develop/infra/infrastructure that should be http://beta-ovirtweb.rhcloud.com/develop/infra/infrastructure/

In the old site, many/most pages had "Contents" automatically generated based on their internal section/subsection hierarchy. IMO we should have that by default for most pages of the new site, perhaps with a simple option to turn off/on. I searched a bit and could not find how to do that and/or whether it's supposed to be supported.

As an example, compare these:

http://old.ovirt.org/Hosted_Engine_Howto

https://www.ovirt.org/documentation/how-to/hosted-engine/

In addition, sections/subsections should be links to themselves, e.g. the title "Migrate existing setup to a VM", both in the menu and in the body, should be a link to the already-working URL:

https://www.ovirt.org/documentation/how-to/hosted-engine/#migrate-existing-setup-to-a-vm

(And, BTW, it will be nice if pressing this link will open it with the section title below the top bar, instead of being covered by it, as it is now at least for me (firefox 45)).

Based on these instructions: https://github.com/blog/2111-issue-and-pull-request-templates

The page: http://beta-ovirtweb.rhcloud.com/develop/infra/www.ovirt.org-configuration/

The links are at the end

If trying to reach the page as ovirt.org (without the www.) it leads to redirect loop

If you go to the 'Decision process' section in that infra page, there's a list that is not rendered properly.

The page is http://beta-ovirtweb.rhcloud.com/develop/infra/infrastructure/

Hi,

The CONTRIBUTING file asks for local testing of changes in the "Test your changes locally" section. But there are no instructions about how to actually do that.

I tried using the standard approach of bundle install && bundle exec ./run-server.sh, but it fails with:

/home/msivak/.gem/ruby/gems/middleman-core-3.3.10/lib/middleman-core/core_extensions/data.rb:167:in `method_missing': undefined method `events' for #<Middleman::CoreExtensions::Data::DataStore:0x00000004b30160> (NoMethodError)
    from /home/msivak/Work/ovirt-site/config.rb:138:in `block in initialize'

I also tried to use the ./docker-setup.sh && ./docker-run.sh script, but that also failed:

[msivak@dhcp131-31 ovirt-site]$ sudo ./docker-run.sh 
Running docker image springboard-20160420-10023
An error occurred while installing nokogiri (1.6.6.2), and Bundler cannot
continue.
Make sure that `gem install nokogiri -v '1.6.6.2'` succeeds before bundling.

So apart from having no instructions, the "obvious" ways do not work either.

Feature pages should be created in /source/develop/features/, and at the moment they're in /source/feature/. The feature template should also be moved there.

On https://beta-ovirtweb.rhcloud.com/develop/release-management/features/ , there is several page, listed in subpage, who do not have a proper title.

Looking at the HTML code, this is likely the subcategory where we have only 1 directory, like cloud ( since the html code is:

<a href='/develop/release-management/features/cloud/'></a> 

Most of the "Slides" links in e.g. [1], e.g. [2], return "page not found".

I can't find any pdf files in the git repo.

Nor can I find how these ":Media:" links are supposed to work, in case I want to fix some of them...

[1] http://www.ovirt.org/community/events/archives/fosdem-2014/
[2] http://www.ovirt.org/community/events/archives/fosdem-2014/:Media:Fosdem-hosted-engine.pdf

In http://beta-ovirtweb.rhcloud.com/documentation/ Reporting a BUG link just point to the oVirt classification bugzilla without saying what to add to the report (like log-collector report, sos report, single log file). It would be better to add a page explaining how to create a useful bug report, with instructions about ovirt teams, projects, components, attachments.

Example of the problem: IPv6 support feature page referrers to the image file that is present in the legacy site and is missing from the new one.

The "About" link in the bottom of all the pages is not leading anywhere.
http://www.ovirt.org/about/

On https://beta-ovirtweb.rhcloud.com/community/about/community-guidelines/

there is some example link that are not transformed to html a tag by middleman. See "To search mailing lists"?

Links to documents in ovirt.org slide decks page are broken, as they point to documents uploaded to old images/ or wp-content/upload folders, which aren't available anymore.
Are these ODPs and PDFs migrated to the new site - can't find them in git repository...

http://www.ovirt.org/develop/release-management/features/heapplianceflow/
has two broken links to jobs that create the hosted engine appliance.
found appliance image in
http://jenkins.ovirt.org/job/ovirt-appliance_ovirt-3.6_build-artifacts-el7-x86_64/

Even if from the new website the previous website page are referenced, they're not reachable anymore so if something gone wrong with the conversion you can't reach the correct one to compare with.

one of them http://beta-ovirtweb.rhcloud.com/develop/infra/infra-bash-style-guide/

The markup after 'Installing Guest Agents and Drivers' corrupts the remainder of the document. Looks like there is some html that is not parsed by the markdown engine and breaks everything afterwards.

This is the raw code where it breaks. I notice it renders properly on github just not on the web site.

Installing the agents and drivers on Red Hat Enterprise Linux guests

All of the drivers are included in the base channel for RHN-registered Red Hat Enterprise Linux virtual machines. They can be installed using the `yum install rhevm-guest-agent` command. Your RHEL guest must be subscribed to the `Red Hat Enterprise Virt Agent` channel to install the agents. In Red Hat Enterprise Linux 5, this channel is labeled `rhel-x86_64-rhev-agent-5-server`. In Red Hat Enterprise Linux 6, the channel is labeled `rhel-x86_64-rhev-agent-6-server`.

Installing the agents and drivers on Windows guests

The guest tools ISO is `ovirt-guest-tools-iso.rpm`, an RPM file installed on oVirt. After installing oVirt, the guest tools ISO can be found at `/usr/share/rhev-guest-tools-iso/ovirt-tools-setup.iso`. When setting up oVirt, if you have created a local storage share for an ISO storage domain, the ISO file is automatically copied to the ISO storage domain. In this case the ISO image is automatically attached to Windows guests when they are created. Otherwise, the ISO must be manually attached to Windows guests for the tools and agents to be installed. Updated versions of the ISO file must be manually attached to running Windows virtual machines to install updated versions of the tools and drivers. If the APT service is enabled on virtual machines, the updated ISO files will be automatically attached.

oVirt Application Provisioning Tool (APT) is a Windows service that can be installed in Windows virtual machines and templates. Attach the guest tools ISO file to your Windows virtual machine and ovirt-Application Provisioning.exe automatically runs to install the APT service.

When the APT service is installed on a virtual machine, attached ISO files are automatically scanned. When the service recognizes a valid oVirt guest tools ISO, and no other guest tools are installed, the APT service installs the guest tools. If guest tools are installed, and the ISO image contains newer versions of the tools, an upgrade is automatically performed.

When the APT service has successfully installed or upgraded guest tools on a virtual machine, the virtual machine is automatically rebooted.

oVirt Guest Drivers and Guest Agents

oVirt provides customized drivers and guest tools to use with Windows and Red Hat Enterprise Linux guests. The drivers allow guests to use enhanced virtual devices that perform better than emulated devices; the guest agents facilitate communication between the guest and oVirt.

⁠

Table 8.15. oVirt Guest Drivers

⁠

Table 8.16. oVirt Guest Agents and Tools

Searching for '3.6.5' doesn't find anything:
http://www.ovirt.org/search/#3.6.5

While it should have found http://www.ovirt.org/release/3.6.5/

Infra page: http://beta-ovirtweb.rhcloud.com/develop/infra/infrastructure/

Comparing http://www.ovirt.org/release/3.6.3/ and OVirt_3.6.3_Release_Notes I mirrored locally before the switch to the new site, I see that the table of contents is missing (just annoying) and all references to the bugs have been lost (real issue).

In older site I had:

• BZ 1191514 - Missing gluster error codes

with the BZ linked to the bugzilla url. It used a macro/template {{BZ|1191514}}
in new site I only see:

• Missing gluster error codes

Can this be fixed?

In http://beta-ovirtweb.rhcloud.com/community/about/contact/ there's no link to facebook, google+. twitter, linkedin pages.

Currently the Blog page shows a list of sub-pages: http://beta-ovirtweb.rhcloud.com/blog/

Is there a way to make it look more like the case-studies page: http://beta-ovirtweb.rhcloud.com/community/user-stories/user-stories/

But only showing one column (not two, like in the case-studies), similar to your standard Tumblr/Wordpress blog layouts?

Server not providing intermediate certificate makes Google Chrome report as untrusted website

• the /events/ page has moved elsewhere; this should be corrected
• check to see if events are being picked up properly, and why they're not showing up
• ensure events are tagged with oVirt in rh-events
• port over event changes from RDO wiki conversion to middleman

Hi,
So after enabling the correct cert, when loading the ssl-enabled page firefox complains about a couple resources not being fetched from secure connections, the resources are:

http://www.redhat.com/j/elqNow/elqCfg.js
http://www.redhat.com/j/elqNow/elqImg.js

The https counterparts already work, so probably it's just a matter of changing a hardcoded url somewhere

Under some circumstances, the hash in the URI might have encoding. Example: %20 instead of a space.

the page: http://beta-ovirtweb.rhcloud.com/develop/infra/jenkins/

Now noticed that a google search returned also results from old.ovirt.org.

If we intend to drop it by end of current month, which btw seems
pretty immature to me - perhaps wait half a year or so, we better stop
google from searching and/or returning results from it. robots.txt
should have been enough if done beforehand, not sure what tools exist
now. Adding one won't hurt anyway. Obviously google has specific tools
for webmasters, we probably want if possible something general for
many search engines.

Already reported to infra mailing list [1], as most of not all of the above is hardly relevant to the new site. Opening also this issue per Mikey's request.

[1] http://lists.ovirt.org/pipermail/infra/2016-March/013636.html

The link to http://www.ovirt.org/blog/2016/03/up-and-running-with-ovirt-3-6/develop/release-management/features/engine/self-hosted-engine-hyper-converged-gluster-support/ is broken.

@jasonbrooks - can you look at this?

the page: http://beta-ovirtweb.rhcloud.com/develop/infra/becoming-an-infrastructure-team-member/

The readme file should be customized to be specifically for oVirt.

• The title of README.md should reflect oVirt.
• If directions do not work or need to be expanded upon, those should also be updated too.

the page: http://beta-ovirtweb.rhcloud.com/develop/infra/infrastructure-instances/

Something in the move did not go well. It is unreadable and is a very important page.

Since @thatdocslady did ask me for a new bug report, let's restart the discussion from #3 here.

So basically, the reuse of the RH privacy policy is inadequate for ovirt.org for several reasons, and i will list just the 2 main ones for now to not overload the issue:

First, it states that RH do not give the information except to partner that signed a confidentiality agreement, law enforcement or in case of merger/acquisition.

Since we have community members who would have access to various informations, we are already breaching the privacy policy, and I think it should be amended, like did the one of Fedora.

Second point, the part about remarketing is something we are not doing, and there is people who would see that weird, me being the first.

So I think we should first have a list of our existing practice regarding private informations, then see which one we are supposed to do or not, and the impact. Then once we have this, we can go to Legal see what can be done to fix the policy to make it correspond to what we do, or if we need to stop doing something (example, logwatch on public list).

We need an actual blog post with content. The site doesn't look right without it.

It would be nice to get this in soon, or at least have a filler post so the layout isn't broken*. (:

(* The site should never have empty blog posts ever again, once it's deployed to production, so it's not a problem.)

the only way to navigate back is hitting the back button, in the wiki you have some hirachized breadcumbs links that help navigating topics

Fedora 23, with all updates.

Running: sudo ./setup.sh

ends with:
Using erubis 2.7.0
Installing expression_parser 0.9.0
Installing favicon_maker 1.3
Installing mini_portile 0.6.0

Gem::Ext::BuildError: ERROR: Failed to build gem native extension.

/usr/bin/ruby -r ./siteconf20151214-31202-1lbjeh2.rb extconf.rb 

checking if the C compiler accepts ... yes
Building nokogiri using packaged libraries.
checking for gzdopen() in -lz... no
zlib is missing; necessary for building libxml2
*** extconf.rb failed ***
Could not create Makefile due to some reason, probably lack of necessary
libraries and/or headers. Check the mkmf.log file for more details. You may
need configuration options.

Provided configuration options:
--with-opt-dir
--without-opt-dir
--with-opt-include
--without-opt-include=${opt-dir}/include
--with-opt-lib
--without-opt-lib=${opt-dir}/lib64
--with-make-prog
--without-make-prog
--srcdir=.
--curdir
--ruby=/usr/bin/$(RUBY_BASE_NAME)
--help
--clean
--use-system-libraries
--enable-static
--disable-static
--with-zlib-dir
--without-zlib-dir
--with-zlib-include
--without-zlib-include=${zlib-dir}/include
--with-zlib-lib
--without-zlib-lib=${zlib-dir}/lib64
--enable-cross-build
--disable-cross-build

extconf failed, exit code 1

Gem files will remain installed in /usr/local/share/gems/gems/nokogiri-1.6.6.2 for inspection.
Results logged to /usr/local/lib64/gems/ruby/nokogiri-1.6.6.2/gem_make.out
An error occurred while installing nokogiri (1.6.6.2), and Bundler cannot
continue.
Make sure that gem install nokogiri -v '1.6.6.2' succeeds before bundling.

The gem mentioned above fails to install as zlib-devel RPM is missing.

Many pages are out of date, simply by the fact that they contain MediaWiki-related information. The pages should either be:

1. Removed
2. Have MediaWiki information removed from the page (and leave other stuff)
3. Changed to reflect similar Middleman-related information

Which method of the above that should be used really depends on the page in question.

To start, here's a search for "MediaWiki":

https://beta-ovirtweb.rhcloud.com/search/#mediawiki

...all of these pages should be looked at and corrected. You can, of course, click on the "Edit on GitHub" link on the bottom of the page if you see anything amiss on a page.