Comments (6)
@wez Unless I'm mistaken, it looks like this is more or less complete or at least getting close to it, ya? So this probably doesn't need to be open anymore.
from wezterm.
Docs are always hard to maintain. I'll give this some thought!
- Dark Mode: It's like staring at the sun.
- Add a button to toggle a dark theme, like a light bulb.
- Just make it dark for everyone because who the hell doesn't use dark mode?
Heh, yeah, I'm a a dark mode fan also!
from wezterm.
Here's my current line of thinking on this:
The nightly (which is actually hourly!) build is to make it easier for folks to try the bleeding edge without needing to set up a compilation environment. It is explicitly considered to be unstable and as such may not work at all and may be half-baked. It's hard to justify stringent documentation requirements for something of that nature.
I generally aim to add docs for new things in the commit messages as the associated features come together, and then when I'm ready to release I'll collect notes into the release (see https://github.com/wez/wezterm/releases) and write up the docs for the website. I think that is a reasonable model, but there is an obvious gap in that the release notes aren't visible on the website that should be addressed.
For configuration options: in earlier versions the config was a few tens of lines of code (mostly comments) that could be linked directly, but as the project has grown it's gotten a bit more complex.
It is technically possible to automatically extract the doc comments from the code, but it is a project in itself to make automatically extracted documentation be actually useful and good.
Another facet of this is that the current TOML config is "OK" but it's not going to work for some the features that I have in mind so I've been working an alternative. I'd rather get that to a good place before investing energy into automation around documentation.
from wezterm.
I had a bit of an odd idea for the configuration. The way Python code formatting works is a lot like YAML. What if wezterm used the embeddable version of Python and compiled it into the wezterm binary (to keep it as a single executable).
Python isn't known for performance, but it's not like you need high performance for this use-case. Any given option could potentially handle both three-state-booleans and strings.
from wezterm.
Also, thanks for reducing the size of the pdb. 👍
from wezterm.
I'm going to lock this issue because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active issues. If you have found a problem that seems similar to this, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.
from wezterm.
Related Issues (20)
- On windows10, using SHIFT in modifiers behaves unexpected, different from macOS. HOT 1
- Add option to pre-populate user prompts with custom text
- Wezterm getting memory allocation failure if configured with large scrollback_lines buffer
- `GLD_TEXTURE_INDEX_2D is unloadable` warning and pixellated/unusable output on Nix aarch64-darwin HOT 1
- Ctrl+Scrolllock crashes Wezterm
- Command execution interface support
- Capital cyrrillic letters are not displayed when using TMUX with `ModifyOtherKeys` option
- WezTerm doesn't do a good job of automatically modifying the wsl2 directory when launching a new tab.
- Builds in copr are broken
- Option for "smart" case sensitive search
- Changing argument to `wezterm.action.Search` has no effect when argument is an empty string
- usage as library/embedding into other application HOT 5
- Nested domains/subdomains
- Tab title not refreshed at toggling debug overlay
- Wezterm window not movable via tab bar on fedora HOT 3
- Allow reduced opacity for dim text HOT 2
- pane:get_foreground_process_info() return nil in multiplexing or ssh mode
- split-pane --move-pane-id can kill panes
- Windows: sixel does not work on wezterm but works on wezterm ssh.
- Wezterm Crash when copying text
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
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.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from wezterm.