search

ctfs / resources

A general collection of information, tools, and tips regarding CTFs and similar security competitions
ctfs.github.io/resources
Creative Commons Zero v1.0 Universal
1.75k stars 278 forks source link

GitHub Wiki? #6

Closed dufferzafar closed 10 years ago

dufferzafar commented 10 years ago

As of now, you need to browse the repository to read stuff.

A wiki might me a better way of displaying our content as reading it feels more 'natural'.

mathiasbynens commented 10 years ago

As of now, you need to browse the repository to read stuff.

That is by design. Isn’t it how hackers are used to reading (code)? Also note that it’s not just about reading prose in this case; this repository contains source files for CTF challenges and the only way to have those be visible in an easily recognizable way is to just have users browse the repository.

A wiki might me a better way of displaying our content as reading it feels more 'natural'.

For reading prose, maybe. But see above.

mathiasbynens commented 10 years ago

The above applies to the https://github.com/ctfs/write-ups repository, but as this repository is part of the same organisation, I think it makes sense for them to use a similar structure.

cabreraalex commented 10 years ago

I also think that at the stage the repository is at now it is much easier to write and organize in a github repository than in a wiki. If it eventually gets to an unmanageable level of complexity, we can transfer it over to a wiki-like structure or website and conserve the work that has been done here.

For now I'm going to keep working on it in the same manner in which the write-ups are, as it seems to have been working well and most people don't find it too challenging to navigate the Github folder structure

dufferzafar commented 10 years ago

I don't actually have any experience with Github Wikis and just hope that converting a stack of README files to a wiki format is easy because I really feel that the content will reach a decent level of complexity.

cabreraalex commented 10 years ago

just saw this: http://www.gitbook.io/

Although this repo is not a book, might be interesting to build off of that

dufferzafar commented 10 years ago

Yeah, it looks nice.