Skip to content

Conversation

@jorgecarleitao
Copy link
Member

Markdown is used throughout the open source community for years and it is a significantly better experience user experience, specially when they are presented in github/gitlab/etc.

By offering the LICENSE in markdown, we can format links, lists, etc, which significantly reduces the barrier for someone to read and navigate in these files.

Markdown is used throughout the open source community for years and it
is a significantly better experience user experience, specially when they
are presented in github/gitlab/etc.
By offering the LICENSE in markdown, we can format links, lists, etc,
which significantly reduces the barrier for someone to read and navigate in
these files.
@jorgecarleitao
Copy link
Member Author

Related to apache/datafusion#966

@sebbASF
Copy link
Contributor

sebbASF commented Sep 6, 2021

I think you need to raise this with legal first.

Note also that the NOTICE and LICENSE files are source files, and are released along with other source.
This will not in general be in Markdown format.

@sebbASF sebbASF closed this Sep 6, 2021
@jorgecarleitao jorgecarleitao deleted the patch-1 branch September 6, 2021 10:29
@jorgecarleitao
Copy link
Member Author

@sebbASF , could you clarify what do you mean with being source files? I understood that these files were to be read by people, not consumed by a compiler or something.

@sebbASF
Copy link
Contributor

sebbASF commented Sep 6, 2021

I meant that the N&L files are intended to be read alongside the other source files when included in the release bundle.

The files will not always be served via an app that handles Markdown.

@houqp
Copy link
Member

houqp commented Sep 6, 2021

The files will not always be served via an app that handles Markdown.

I think this makes sense and matches my expectations as well.

I am curious if there is any legal issue that disallows use of md extension here? I do think this would be an improvement for some of the projects for cases when the file did end up being served through interfaces that renders markdown files. For example, our README.md files also will not always be served via an app that handles markdown, but in case it does (GitHub web UI), it helps our users a lot. On the other hand, readmes are not legal disclaimers like N&L, so perhaps I am missing something here?

@sebbASF
Copy link
Contributor

sebbASF commented Sep 6, 2021

N&L are legal files. Any changes must be agreed by ASF Legal.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants