diff options
Diffstat (limited to 'en/support')
-rw-r--r-- | en/support/index.php | 104 | ||||
-rw-r--r-- | en/support/report-a-bug/index.php | 113 |
2 files changed, 217 insertions, 0 deletions
diff --git a/en/support/index.php b/en/support/index.php new file mode 100644 index 000000000..8b3ea46bd --- /dev/null +++ b/en/support/index.php @@ -0,0 +1,104 @@ +<?php + +define('HLANG', true); +require '../../langs.php'; +$dictionary = read_translation_file($locale, 'support'); + +?><!DOCTYPE html> +<html dir="ltr" lang="<?php echo $locale; ?>"> +<head> + <meta charset="utf-8"> + <title><?php _g('Support for Mageia distribution')?></title> + <meta name="description" content="<?php _g('List of support resources for Mageia distribution.')?>"> + <meta name="keywords" content="<?php _g('mageia, linux, support, help, hardware, qa, test')?>"> + <meta name="author" content="Mageia"> + <link rel="stylesheet" type="text/css" href="/g/style/all.css"> + <?php include '../../analytics.php'; ?> +</head> +<body class="support"> + <?php echo $hsnav; ?> + <header id="mgnavt"> + <h1><?php _g('Support')?></h1> + <ul> + <li><a href="#comm"><?php _g('Community Support')?></a></li> + <li><a href="#pro"><?php _g('Professional Support')?></a></li> + <li><a href="../doc/"><?php _g('Documentation')?></a></li> + <li><a href="//advisories.mageia.org/"><?php _g('Updates')?></a></li> + <li><a href="#lifecycle"><?php _g('Lifecycle')?></a></li> + <li><a href="#hw"><?php _g('Hardware Requirements')?></a></li> + <li><a href="//bugs.mageia.org/"><?php _g('Bugs Reports')?></a></li> + </ul> + </header> + <div id="doc" class="yui-t7"> + <div id="bd" role="main"> + <div class="yui-g"> + <div class="para donate" style="padding-top: 2em;"> + <?php + _g('Documentation', null, 'h2 id="docu"'); + _g('You can look up existing %sdocumentation here%s. You may too look into our %sWiki%s.', + array('<a href="../doc/">', '</a>', + '<a href="https://wiki.mageia.org/">', '</a>'), 'p'); + echo '<hr>'; + + _g('Updates', null, 'h2 id="updates"'); + _g('Updates are available for %s and %s (security and bug fixes) and published on an ongoing basis.', array('<a href="//advisories.mageia.org/3.html">Mageia 3</a>', '<a href="//advisories.mageia.org/4.html">Mageia 4</a>'), 'p'); + _g('You can install these from the Mageia Control Center.', null, 'p'); + _g('You may subscribe to our %s announce list to be notified of these.', array('<a href="https://ml.mageia.org/l/info/updates-announce">updates-announce</a>'), 'p'); + echo '<hr>'; + + _g('Lifecycle', null, 'h3'); + _g('Mageia releases are supported at least for 18 months.', null, 'p'); + echo '<ul class="hl">'; + _g('Mageia 4 will be supported until August 1st, 2015.', null, 'li'); + _g('Mageia 3 will be supported until November 19th, 2014.', null, 'li'); + _g('Mageia 2 was supported until November 22nd, 2013.', null, 'li'); + _g('Mageia 1 was supported until December 1st, 2012.', null, 'li'); + echo '</ul>'; + echo '<hr>'; + + _g('Community Support', null, 'h2 id="comm"'); + _g('If you need help, information or directions about the Mageia distribution you installed or about the project, you can try to reach us through:', null, 'p'); + + echo '<ul class="hl">'; + _g('<a href="https://forums.mageia.org/en/">Community support forums</a> in English – see <a href="https://forums.mageia.org/en/viewforum.php?f=20">other Mageia community forums</a> for support in your language;', null, 'li'); + _g('IRC channels where you can discuss live with other Mageia users and contributors: <a href="irc://irc.freenode.net/#mageia" hreflang="en">#mageia</a> or other localized <a href="https://wiki.mageia.org/en/IRC#channels_in_other_languages">channels</a>;', null, 'li'); + _g('our <a href="https://wiki.mageia.org/en/">Wiki</a> (still rough at the time, we are working on it!);', null, 'li'); + _g('our <a href="https://wiki.mageia.org/en/Mailing_lists" hreflang="en">mailing-lists</a>;', null, 'li'); + _g('local events: follow our <a href="https://blog.mageia.org/en/">blog</a> and <a href="https://www.mageia.org/en/calendar/">calendar</a>.', null, 'li'); + echo '</ul>'; + echo '<hr>'; + + _g('Professional Support', null, 'h2 id="pro"'); + _g('Mageia.Org does not provide or endorse commercial/professional support or other services around the distribution. But there are organizations providing such services and more.', null, 'p'); + _g('Please check the <a href="%s">commercial vendors</a> list', array('https://wiki.mageia.org/en/Commercial_vendors'), 'p'); + echo '<hr>'; + + + _g('Hardware Requirements', null, 'h2 id="hw"'); + _g('Mageia software runs on most x86 computer systems available as of today, April 2011.', null, 'p'); + _g('You can follow this hardware requirements list:', null, 'p'); + echo '<ul class="hl">'; + + _g('Processor: any AMD, Intel or VIA processor;', null, 'li'); + _g('Memory (RAM): 512MB minimum, 2GB recommended;', null, 'li'); + _g('Storage (HDD): 1GB for a minimal installation, 6GB for a full setup;', null, 'li'); + _g('Optical drive: CD or DVD depending on the ISO you use (network, USB key installation available);', null, 'li'); + _g('Graphic card: any ATI, Intel, Matrox, nVidia, SiS or VIA graphic card;', null, 'li'); + _g('Sound card: any AC97, HDA or Sound Blaster sound card.', null, 'li'); + echo '</ul>'; + + _g('For some kinds of hardware (Wi-Fi chipsets, 3D graphic cards) to work properly, specific firmware or software may be needed, this is available in a specific online repository called "nonfree" (<a href="https://wiki.mageia.org/en/Install_media_in_Mageia_2_for_beginner#Types_of_Mageia_media">learn more</a>).', null, 'p'); + _g('We may set up a hardware compatibility list/directory as well as a hardware certification process; but that\'s still at the planning stage. Feel free to join/contact our <a href="%s">Web</a> and <a href="%s">QA</a> teams if you would like to help in this regard.', array('https://wiki.mageia.org/en/Web_team', 'https://wiki.mageia.org/en/QA_Team'), 'p class="dlinfo"'); + echo '<hr>'; + + _g('Bugs Reports', null, 'h2 id="bugs"'); + _g('You may check and report bugs on <a href="%s">our Bugzilla (bugs.mageia.org)</a>.', + array('https://bugs.mageia.org/'), 'p'); + echo '<hr>'; + ?> + </div> + </div> + </div> + </div> +</body> +</html> diff --git a/en/support/report-a-bug/index.php b/en/support/report-a-bug/index.php new file mode 100644 index 000000000..f8b64964e --- /dev/null +++ b/en/support/report-a-bug/index.php @@ -0,0 +1,113 @@ +<!DOCTYPE html> +<html dir="ltr" lang="en"> +<head> + <meta charset="utf-8"> + <title>How to report a bug | Mageia</title> + <meta name="description" content="How to report a bug for Mageia."> + <meta name="keywords" content="mageia, linux, bug, report, procedure, support, help"> + <meta name="author" content="Mageia"> + <link rel="stylesheet" type="text/css" href="/g/style/all.css" > + <?php include '../../../analytics.php'; ?> +</head> +<body class="support report-a-bug"> + <?php include '../../../langs.php'; ?> + <h1 id="mgnavt"><a href="../">Support</a> » How to Report a Bug</h1> + <div id="doc" class="yui-t7"> + <div id="bd" role="main"> + <div class="yui-g"> + <div class="para donate" style="padding-top: 2em;"> + <div class="qsidesummary"> + <ol> + <li><a href="#update">Update your system</a></li> + <li><a href="#reproduce">Reproduce the bug</a></li> + <li><a href="#go">Go to bugs.mageia.org</a></li> + <li><a href="#search">Search for similar bugs</a></li> + <li><a href="#file">File a new bug</a></li> + <li><a href="#follow">Follow up</a></li> + <li><a href="#thx">Thank you!</a></li> + <li><a href="#more">More</a></li> + </ol> + </div> + + <h2 id="update">1. Update your system.</h2> + <p>Make sure your system is up-to-date, + and double-check if you still encounter the same bug.</p> + <p>If not, that means that an installed update may have fixed the bug + – you may stop here.</p> + + <hr /> + <h2 id="reproduce">2. Reproduce the bug.</h2> + <p>Make sure you can reproduce the bug, and how you do it.</p> + <p>If not, it will be difficult for developers to identify and fix this bug. + But if you still think this is important enough to be reported, continue.</p> + + <hr /> + <h2 id="go">3. Go to <a href="https://bugs.mageia.org/">bugs.mageia.org</a>.</h2> + <p>… and sign in with <a href="https://identity.mageia.org/">your Mageia account</a>. + If you do not have an account yet, + you can <a href="https://identity.mageia.org/register">register one</a>.</p> + + <hr /> + <h2 id="search">4. Search for a similar bug.</h2> + <p>This bug may have been reported already. So search for it using the search box.</p> + <p>If there is one such similar bug:</p> + <ul> + <li>has it been resolved already? does the proposed resolution work for you?</li> + <li>is it still pending resolution? then try to see if + you can add relevant information into the comments + section of the bug (bottom of the page).</li> + <li>do you want to be notified of updates relative to this bug? then add yourself in the Cc list.</li> + </ul> + <p>If you found no similar bug, or if the resolution doesn't work for you, you may continue.</p> + + <hr /> + <h2 id="file">5. File a new bug.</h2> + <p>Choose the Product, Component, Version, Hardware Platform that best match + the context of this bug. Put the name of the Source RPM of the package + (see below for more details).</p> + + <p>Write a clear summary explaining the bug, in a few words.</p> + + <p>Explain the bug in details, following the template provided to you in the report form.</p> + + + <p>Attach the documents that seem relevant and informative about this bug.</p> + + <p>Assign the bug to the packager maintainer (or let the triage team add it)</p> + + <p>Post your bug.</p> + + <hr /> + <h3>Document your bug!</h3> + <p>It is crucial that you gather information about your bug:</p> + <ul> + <li>what is the software involved? what is the package, source package of it?</li> + <li>who is the maintainer?</li> + <li>do you have a log file or a screenshot that may help demonstrate the problem?</li> + </ul> + <p><code class="term">$ rpm -qi package</code></p> + <p>will give you a lot of informations about a package already: source package name, maintainer, etc.</p> + + <hr /> + <h2 id="follow">6. Follow up.</h2> + <p>Your bug will be reviewed by the Triage team and/or the maintainer of the package, + or other contributors. + It will help a lot that you answer their questions so they can get a better picture + of the issue at hand and fix it more quickly.</p> + <p>Similarly, your bug may be silently fixed in a later release. + If so, consider closing your bug on your own.</p> + + <hr /> + <h2 id="thx">7. Thank you!</h2> + <p>Thanks to take the time to report to us about your experience + of Mageia. This will help make it a better operating system for everyone.</p> + + <hr /> + <h2 id="more">More.</h2> + <p>For a more detailed description of <a href="https://wiki.mageia.org/en/Bugzilla#How-to_report_a_bug">how to report a bug</a>.</p> + </div> + </div> + </div> + </div> +</body> +</html> |