Code Monkey home page Code Monkey logo

mumble-www's Introduction

The Mumble Website

Source of the Mumble Website. The live website is available at www.mumble.info.

Implemented through static files generated with hugo, their source resides in the hugo folder.

After navigating into the hugo folder: The hugo command will place the generated website files in the public folder. An interactive, auto-updating development server can be launched with hugo server.

Source and Content License

This repository contains the sources and content for the Mumble website. They are licensed under a BSD 3-clause license; see the LICENSE file.

For licenses of other works of the Mumble project, please see the respective license information.

mumble-www's People

Contributors

avatat avatar davidebeatrici avatar forivall avatar hacst avatar hartmnt avatar joshproehl avatar kissaki avatar krzmbrzl avatar lieuwex avatar mkrautz avatar natenom avatar notr1ch avatar toby63 avatar vrifox avatar

Stargazers

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

Watchers

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

mumble-www's Issues

Figure out what to do with LICENSE and AUTHORS permalinks

Right now we use the permalinks https://www.mumble.info/LICENSE and https://www.mumble.info/AUTHORS in our LICENSE.header, LICENSE, AUTHORS, etc. to point people to an up-to-date LICENSE or list of authors.

Ideally, we would want this to be automated somehow. Already now, we're forgetting to update these files on the live site.

Now that we use Hugo, the "obvious" way would be to just include them statically. But I worry that they'll grow stale.

Can we do something dynamic here? Obviously, we could write a simple server for our Hugo site, which has dynamic handlers for /LICENSE and /AUTHORS.

Thoughts? /cc @bontibon

Add prominent donate/support financially information

Context: I went to mumble.info to donate $$ to the project, but I couldn't find the donate button. First I looked down the center column, then down the right column, then down the left column. Then I did a ctrl+f to search for "donate" on the page. Clearly my eyes had missed the link in the left column. Perhaps because is undifferentiated from the rest of the content on the page!

Feature:

Place a "Donate" link with large text at the top center of the mumble.info home page. Include a "Paypal" icon so people immediately associate this link with the concept of payment. A

lternative position: duplicate the "Download mumble" column with a "Donate to mumble" column above, so users must browse past the donate section every time they download.

This section could include information about who receives the donations and what they are spent on. Project productivity statistics could be included here as well, such as: active developers, bugs fixed recently, release cadence, and importantly, SERVER COSTS! :)

Opening `https://mumble.info/` asks for a user certificate

Opening https://mumble.info/ asks for a user certificate, which it should not.

Opening https://www.mumble.info/ does not.

Note that for me it asks only once. When I cancel, opening it again does not again. In Firefox. I guess because it remembers.

Opening a new private browser windows the issue occurs again. Opening another private tab or window does not. But closing and opening a new private browser window, it occurs again.

OS X should be macOS

OS X is called macOS since version 10.12.

Maybe the download page should reflect that?

Set up a form on the website to report issues

<agris> I do not have a Microsoft/Github account as I do not accept the privacy policy and terms of service. Is there another way to open a ticket?
<davidebeatrici> I understand. Would you like me to open an issue for you?
<agris> If there is no other way, I would appreciate that. However if that is so, would you mind opening another ticket about having a way to contribute without a Microsoft account?

Add Downloads page

We should add a Downloads page to the site.

The front page should include the most obvious download a user would want.
But we should have a separate page as well, to allow people to download specific products.

Such a page should encompass what's currently handled by the wiki's Download and Third Party Applications sections:

image

Provide Security information

We have https://www.mumble.info/security for a list of published security vulnerability information which we link to from nowhere atm afaik,
and I added /.well-known/security.txt which has contact information.

Both should be reachable from the homepage/wiki.

See also #18; we could add our GPG sign keys for builds/releases on the topic of security, maybe add some information about security measures in use by Mumble itself.

Migration of the blog from blog.mumble.info to www.mumble.info

Once the new site goes live, we'll need redirects in place from the old Wordpress blog.

It'd be cool if we could if we could prepare something we could use for that migration.
I'm thinking it's probably going to be a list of mod_redirect statements we can drop into the original host for blog.mumble.info -- at least to begin with.

Any takers? :)

Travis CI: Fastly 503 first byte timeout when accessing MXE mirror

See https://travis-ci.org/mumble-voip/mumble/jobs/332076111

We now get the following error:

E: Failed to fetch https://dl.mumble.info/mirror/pkg.mxe.cc/repos/apt/debian/pool/main/m/mxe-i686-w64-mingw32.static-gnutls/mxe-i686-w64-mingw32.static-gnutls_3.5.8-20170208_amd64.deb  503  first byte timeout

which is odd to me. I guess it means that our origin is too slow at serving the file to Fastly? Or maybe its our internal Varnish?... Not sure yet.

Figure out how to generate slice documentation in the future

Our generated slice documentation has always been a very simple html file structure.

Ice 3.6 still contains the slice2html executable. Ice 3.7 does not and tells you to use doxygen, which supports slice.

See v3.6-Usingslice2html and v3.7 Using Doxygen for Slice Documentation.

The doxygen generated HTML documentation is a lot more complex and IMHO overkill, and reduces readability and discoverability instead of improving it.

We should explore and decide on how we want to handle this in the future. Possibly establish a (documented or automated) generation workflow.

Ice has moved from slice file and dynamic type usage to generated code for more languages (namely PHP as well). Arguably, the generated types are enough with a decent IDE. Although being able to link to types and read them without generated code available would be very useful at times.

This issue became apparent in #60.

Content headline levels break toc link list

Is (markdown) content supposed to use level 1 or level 2 headings?

Only one h1 should exist. Which is used for the page title (and website header title).

Consequently, it should be h2s, right?

But that breaks the toc links because the list starts at level 2:

image

Fix Makefile

I was just checking out what you guys were doing and ran into an issue with the Makefile.

I fixed it with the following:

diff --git a/Makefile b/Makefile
index 62e594d..0d13e21 100644
--- a/Makefile
+++ b/Makefile
@@ -1,10 +1,12 @@
+VPATH = src
+
 all: public mumble-www package
 
 public: $(shell find hugo/ -type f)
        (cd hugo/; hugo)
 
 mumble-www: mumble-www.go githubcache.go snapshotcache.go config.go downloads.go programflags.go
-       (cd src/; GO111MODULE=on go build -o ../$@ $^)
+       (cd src/; GO111MODULE=on go build -o ../$@ $(^F))
 
 package: public mumble-www
        7z a mumble-www.7z public mumble-www

The rule prerequisites are not available in the current directory. I'm no make master, so I'm sure there's a more elegant solution than mine.

Create config management script for production setup

Use Ansible or another config management system to setup the host that will run the website.

The goal would be to make it easy to stand up the website if the host underneath needs to be recreated.

I don't think this needed for release, but it would be a nice to have.

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.