The following were added to code and not documented:

• schedule
• scheduleIdentifierType

We should have some.

Require all supported modules shown to include a screenshot. Its just absurd to talk about GUI apps and widgets without any pictures.

wtfutil/wtf#675

The security widget is supposed to show the firewall status. This works great in Windows where 99% of users are running windows in single-user mode (as Administrator). However, in linux, in most distributions of the defualt installations, have to be root or use sudo with password in order to get the correct firewall info. I.e. to run sudo ufw status. This fails on several levels in the security widget.

There are 3 work-arounds:

1. by creating a new firewall group and add your user to it.
2. by enabling full access to the firewall indiscriminately to all users, which create a huge security hole.
3. run WTF as root, which is definitely not recommended, and create it's own issues with GO installation.

1 is the way to go and need to be documented

Added in wtfutil/wtf#373

Hey,

I'm a big advocate for static docs sites and Hugo in particular (I'm a contributor). I see that this docs site is built with Hugo but not on CI.

I propose that this site gets built on CircleCI, this way PRs can be checked automatically before merging. There's a tool that I've used with Hugo and Jekyll-based websites called HTML Proofer that can test the generated static site for errors. My favorite usecase for it is to check for broken links though it can also check your HTML structure as well to make sure that well formed HTML pages are being generated.

A few examples of how this works:

Feliciano.Tech/config - my personal site, built with Hugo and tested with HTML Proofer
CircleCI Docs/config - CircleCI's documentation website, built with Jekyll and tested with HTML Proofer
Patheon Docs/config - Docs site for Pantheon Hosting, though they're using Gatsby instead of Hugo

I can get a PR going if this sounds good. Just wanted to ask/discuss first.

Point them to the unified source instead.

Per this PR wtfutil/wtf#607

https://github.com/wtfutil/wtf/pull/877/files#diff-6e1bcc7ca6a581fd5c6339d18d5d04a7R38

What should it do?

Explicitly stated that the openFileUtil configuration item needs to be restarted to take effect.

What have I met?

I tried to modify the openFileUtil configuration item, but it didn't work. After reading the source code, I realized that this configuration item needs to be restarted to take effect. But I cannot get the instructions from the documentation (including wtfutil.com).

So I hope that you can further explain this configuration item in the documentation, thanks.

It looks like 86e433c broke the Modules list in the sidebar. For example, see the following, in which it the list of modules is missing:

• https://wtfutil.com/modules/github/
  • 86e433c#diff-d492eeadfcf67bc5923d0e0a333d5dea
• https://wtfutil.com/modules/opsgenie/
  • 86e433c#diff-db2c26e7df517a72f10f646592e2b25e

wtfutil/wtf#724

At the bottom of each module is a source code path. It should provide a link to the source code in wtfutil/wtf.

To match how module settings are documented.

Also check it for completeness. It's probably missing some settings.

Now that this PR by @retgits has added a module generator, document it here under "Getting Started" as its own section.

Some modules have no link to their source code at the bottom.

Fix them with {{% sourcePath module="googleanalytics" %}}

Is there any information on how to uninstall wtf? I'm wary of installing anything that doesn't have a clear back out plan.

wtfutil/wtf#777

I'd love to see a one-page list of pictures of each individual module with a short description of what it does.

In all modules that support env vars for sensitive settings, document that that value can also be defined using a module-specific env vars, ie: GitHub for apiKey, baseURL, uploadURL, etc.

https://github.com/wtfutil/wtf/blob/master/modules/github/settings.go#L37

Per the examples raised in this issue, CmdRunner cannot run everything. Some documentation and tips for trouble-shooting would be helpful.

"There's a detailed screenshot but I can't zoom to see the detail because the website designer has gone the extra mile to make it non-zoomable. Why do people do this?"

meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no"

https://github.com/wtfutil/wtf/tree/master/modules/uptimerobot

wtfutil/wtf#680

wtfutil/wtf#683

• Running WTF on linux without being root has a few consequences (but is the recommended way).
  I.e. #15
• Running as root, has other drawbacks, not making wtf run out-of-the box, unless it was cloned and installed by root

This would allow to give a short description/title as social card embed, e.g. on social networks such as discord.

https://github.com/vantagedesign/ace-documentation

Missing documentation for graphStars and graphIcon.

https://github.com/wtfutil/wtf/pull/824/files

Having the src entry at the top above more useful information doesn't make much sense. Most users won't care about where the module lives in the code, they care about how to configure the module to get it to work.

Put developer stuff last.

Should be below OpsGenie. And are also poorly written. Config example missing attributes.

It contains keyboard information for the Todo module describing capabilities that do not exist in the Todoist module.

With examples on how to configure them, from the PR

Is at top of module list, should be alphabetically sorted.

From this PR: wtfutil/wtf#905

Delete whatever is hijacking native scrolling on mobile

Installation link in "See Installation for additional installation options" on Getting Started throws a 404.

On further investigation, the error occurs due to link redirecting to https://wtfutil.com/getting_started/getting_started/installation/ instead of https://wtfutil.com/getting_started/installation/

Adding the verbose flag to the Quick Start commands may help telling the user that something is actuay happening, instead of a dead terminal for (several minutes) on an old machine.

Please rewrite to:

go get -v -u github.com/wtfutil/wtf

In the documentation of the Azure DevOps module the property orgUrl is misnamed. As it can be seen in the source code the property name is actually orgURL.

wtfutil/wtf#918