-
Notifications
You must be signed in to change notification settings - Fork 1
Thoughts on GitHub, Issue Tracker, Gollum Wiki, etc.
- Playing with Github wiki (Gollum) features
- WORKAROUND: linking between GitHub issue tracker and wiki
- Bitching
As I start using the GitHub wiki I'm impelled to make many complaints, marked as "GitHub wiki bitch" and similar such.
- Q: is there a page tree display in the GitHub wiki?
- I prefer to use Markdown syntax, because it knows how to color links to pages that do not exist yet red.
- I would like to use AsciiDoc, but the AsciiDoc link/cross reference syntax is clumsy
- not only does it seem that links break when their target page name changes
- but there doesn't seem to be auto complete when using the pseudo-GUI link facility?
- I guess I've been spoiled by Confluence
- but at least I'll have this when I returned to editing these things in Emacs
- No redirects in GitHub wikis? not even in MediaWiki?
Probably not needed for the GitHub wiki's main markup language, Markdown, but it is a pity that they are not provided for the MediaWiki Markdown that is also supported by the GitHub wiki.
As I have said many times, the ability to have something appear under multiple names is really important.
- Q GitHub Issue Tracker: want 2nd line quick summary, below title
The issue title started as
- Verify that the recommended partial instruction completion loop constructs for CMOs operate correctly if optional prefetches or hints are treated as NOPs.
- A: not for the POR [hi,lo] form. The nbytes forms could work, but are not POR
- Verify that the recommended partial instruction completion loop constructs for CMOs operate correctly if optional prefetches or hints are treated as NOPs. (A: not for the POR [hi,lo] form. The nbytes forms could work, but are not POR)
Sure, the information should be somewhere in the comment history. But I'd like to see it near the top, for standard reports. Having to search for comment history sucks, especially if somebody wants to add comments after the final resolution is been decided. As in all things, it is possible this issue tracker has this feature, and I may not have found it yet.
- GitHub issue tracker links to GitHub wiki are inconvenient
- Copy/paste screen-snips into GitHub issue tracker
Yeah, I'm to blow the lazy to put into a file and then upload link to it. Copy/paste is a heck of a lot faster, and produces more high-quality bugs than having the level of indirection.
IIRC you can copy/paste into the GitHub wiki. Why not into the issue tracker?
(Yeah, yeah, file size, malware, ...)
- GitHub issue tracker not off-line?
I think diagrams are really, Really, REALLY important for computer architecture.
For that matter, I think comparative tables are also important. Although one can create tables using the GitHub wiki, other table editors are much better. Starting off with spreadsheets like Excel or Google sheets, but also extending to other wiki tables where you can sort and rearrange fields.
Unfortunately, one cannot attach special file types like images directly to the GitHub wiki. One can link to images, e.g. stored in the actual repository. But that loses the benefit of version control within the wiki. One must rely on the version control within the repository. Which is not necessarily in sync with the wiki.
Anyway:
Here's a first attempt at linking to shared LucidChart diagram:* note: needs prettification * [[Glew wish for links with both numeric ID and human readable name]]