Re: Suggestion: reformat docs to Markdown and alias git.nmap.org?

[Paulino Calderon <paulino () calderonpale com>]

Hey Jacek and list,

I think that in the case of todo.txt the difference won’t be very noticeable as not many formatting tags are required. 
However, other documents like HACKING.txt would improve a lot because of code block tags and such. I also agree this 
isn’t a lot of work so it could be worth it. 

I recently moved a bunch of projects to gitlab and it has worked great so far. All the features including issue tracker 
are there. Nice UI. The only downside I can think of is that ocasional contributors who might want to create PRs are 
more likely to have a github account already.  Still, as you said, how hard it is to create a new account hehe.

Cheers.

> On Jan 27, 2016, at 11:28 AM, Jacek Wielemborek <d33tah () gmail com> wrote:
>
> List,
>
> I was just experimenting with an update to my response in "Newbie
> contributer to NMAP" thread [1], with an intent to put in on secwiki. I
> realized that on this mailing list we're getting into the habit of
> pointing people to Github version of Nmap source code instead of
> svn.nmap.org (which makes sense, because this way we're getting syntax
> highlighting).
>
> I was thinking of pointing to a Github version of todo.txt and had this
> thought that it would be nice to have those in a Markdown version. It
> wouldn't really be a lot of effort (basically use "-" instead of "o" for
> list bullets) or make it less readable (just use .md instead of .txt,
> which might annoy Windows users anyway, but how many hackers can't
> really use "open with" feature?). Actually, we could consider doing that
> to the rest of the docs. In addition to that, maybe it would make sense
> to rename HACKING.txt to README.md?
>
> Also, perhaps it would make sense to set up git.nmap.org as an alias to
> gitub.com and route people through this URL? I'm not sure if it would
> work, but if it did, we'd keep control of the source domain for the
> future reference.
>
> BTW, I recently checked out Gitlab and if there's any chance that Nmap
> is still looking for a reasonable self-hosted Git system, this one might
> actually be perfect. It's basically an open source clone of Github that
> is trivial to set up. Definitely worth looking at.
>
> Cheers,
> d33tah
>
> [1] http://seclists.org/nmap-dev/2014/q1/2
>
> _______________________________________________
> Sent through the dev mailing list
> https://nmap.org/mailman/listinfo/dev
> Archived at http://seclists.org/nmap-dev/

_______________________________________________
Sent through the dev mailing list
https://nmap.org/mailman/listinfo/dev
Archived at http://seclists.org/nmap-dev/