Skip to content

slack project markupdown 2020 01 14

akabeko edited this page Jan 19, 2020 · 1 revision

2020-01-14

Time (UTC) Icon Name Message
01:35 uetchy ドラフトの置き場所として、リアルタイムで共同編集出来て、Markdown記法が使えて、公開リンクを作ることができるプラットフォームを探しています。
Dropbox Paperが最初有望だと思いましたが、一番最後の要件が満たせなかったため代替が必要になりました
01:35 Kiara Translation 🇬🇧: I'm looking for a platform where drafts can be collaborated in real time, use Markdown notation, and create public links.
I thought Dropbox Paper was promising at first, but couldn't meet the last requirement, so I needed an alternative
01:35 uetchy 他の候補
- Notion https://notion.so

これ以外に良い候補が無ければNotionにしようと思います
01:35 Kiara Translation 🇬🇧: Other candidates
-Notion
01:53 shinyu Dropbox Paperのリンク、Dropboxにログインしていない状態でもブラウザで開くことができますが、それではだめなのでしょうか?

例:
https://paper.dropbox.com/doc/Vivliostyle-Flavored-Markdown--AsUNfv0t~poXBM39CTAhBwVZAg-ns9bH52Mn1GvLOLI07SAZ
Custom Markdown syntax specialized in book writing.
1. Rule of least surprise
2. Should be lined and matched to other Markdown syntax
3. Backward compatibility (should not be incorrectly rendered in Markdown editor)
Frontmatter
01:53 Kiara Translation 🇬🇧: Dropbox Paper link, can be opened in the browser even if you are not logged in to Dropbox, is that not the case?

Example:
https://paper.dropbox.com/doc/Vivliostyle-Flavored-Markdown--AsUNfv0t~poXBM39CTAhBwVZAg-ns9bH52Mn1GvLOLI07SAZ
01:54 uetchy "見るだけ"のロールが設定できないです。リンクを知っている人はだれでも閲覧&コメント出来る状態です
01:54 Kiara Translation 🇬🇧: I can't set the role of "just see". Anyone who knows the link can view and comment
01:58 uetchy また、共有リンクのロールが「閲覧&コメント」になっていると、フォルダに対してメンバーを招待した際に、そのメンバーをさらにフォルダ内のファイルごとに個別に招待しないと編集権限を付けられない仕組みになっていて面倒です
01:58 Kiara Translation 🇬🇧: Also, if the role of the shared link is "Browse & Comment", when you invite a member to the folder, you can not give edit permission unless you invite the member individually for each file in the folder It's a mechanic and troublesome
01:58 uetchy リンクはGitHub Issueにも置いているので、"見るだけ"が出来ないのはちょっと不便かなと思いました
01:58 Kiara Translation 🇬🇧: Since I put the link on the GitHub Issue, I thought it was a little inconvenient to be unable to "just see"
02:09 akabeko 案の一つとして。この間、vivliostyle-wiki からリネームされた以下を使うのはいかがでしょうか?
vivliostyle/discussion: Discussion & meeting log
https://github.com/vivliostyle/discussion

ここには最小限の LICENSE と README、Wiki が配置されていますが、リポジトリーとして draft/ のようなディレクトリーを設けて Markdown ファイルを置き、編集してゆきます。
このリポジトリーであればコミット権は我々に限定されますし、Git としての履歴、GitHub issues の機能などを利用できます。
策定の過程 (commit) と議論 (issues) もほどよいアクセス制限をもたせながら公開できると思うのですが、いかがでしょうか。
Discussion & meeting log
02:09 Kiara Translation 🇬🇧: As one of the plans. In the meantime, how about using the following which was renamed from vivliostyle-wiki?
vivliostyle / discussion: Discussion & amp; meeting log
https://github.com/vivliostyle/discussion

Here, a minimal LICENSE, README, and Wiki are located, but a directory like draft / is set up as a repository, and a Markdown file is placed and edited.
With this repository, commit rights are limited to us, you can use the history as Git, the features of GitHub issues, etc.
I think you can publish the commit process and issues with reasonable access restrictions.
02:10 akabeko 難点としては共同編集がリアルタイムでないことですね。
02:10 Kiara Translation 🇬🇧: The drawback is that collaborative editing is not real-time.
02:11 uetchy 共同編集の重要度は高くないのでリポジトリにMarkdownを置いて編集していく形でも良いかもしれません
議論はリアルタイム性の高いここでやれば良いでしょう
02:11 Kiara Translation 🇬🇧: The importance of collaborative editing is not high, so it may be good to put Markdown in the repository and edit it
Discussion should be done here with high real-time nature
02:12 uetchy vfmのリポジトリを作って、そこにspecを置く形が良さそう
02:12 Kiara Translation 🇬🇧: Is it possible to create a vfm repository and put specs there?
02:16 akabeko この間の開発者会議で @uetchy さんもおっしゃってましたが、開発と議論が活況であることがそのままプロジェクトの宣伝になります。
その目的で https://github.com/vivliostyle/discussion とリネームして、ここの issues を使って議論を公開するのはどうか?とのことでしたので、こうした規格を決めるのであれば格好の題材になるのではと思いました。
既に

Mark↑↓ · Issue #61 · vivliostyle/discussion
https://github.com/vivliostyle/discussion/issues/61

という issue もありますね。
<https://user-images.githubusercontent.com/431808/72223580-c0e6f100-35b3-11ea-8b00-bbd6d863ceb7.png
02:16 Kiara Translation 🇬🇧: As you mentioned at the developer conference during this time, the vibrant development and discussion will be used as a publicity for the project.
Why not rename it to https://github.com/vivliostyle/discussion and use this issue to publish a discussion? So I thought that if we decided such a standard, it would be a good subject.
already

Mark ↑ ↓ Issue # 61vivostyle / discussion
https://github.com/vivliostyle/discussion/issues/61

There is also an issue.
02:22 uetchy そうですね、基本的な議論は
https://github.com/vivliostyle/discussion/issues/61(日本語・英語OK)
で行い、議論中に参照するドラフトは今後実装が置かれる予定のvivliostyle/vfmに合わせて置く形にすると良いと思います。
02:22 Kiara Translation 🇬🇧: Well, the basic argument is
https://github.com/vivliostyle/discussion/issues/61 (Japanese / English OK)
I think that it is good to put the draft to be referred during the discussion according to vivliostyle / vfm where the implementation will be placed in the future.
02:25 uetchy リポジトリ名をvfmにするか、markdownにするかは迷っています。
npmに@vivliostyle/markdownと@vivliostyle/vfmのどちらで公開するかの話に繋がるので。
02:25 Kiara Translation 🇬🇧: I'm not sure if the repository name will be vfm or markdown.
It will lead to the discussion of whether to release @ vivliostyle / markdown or @ vivliostyle / vfm on npm.
02:26 akabeko vivliostyle/vfm を新設するのであれば https://github.com/vivliostyle/discussion/issues/61 もそちらへ移動するほうがよいですかね。
実装と議論を密にするか、あくまで vivliostyle/discussion が公開議論 (討論) の場であり実装は実装へ直に関連する issue だけ管理するか。
について考える必要がありそうです。
02:26 Kiara Translation 🇬🇧: If you create vivliostyle / vfm, should you also move https://github.com/vivliostyle/discussion/issues/61 there?
Is the discussion closely with the implementation, or is vivliostyle / discussion a place for public discussion (discussion) and the implementation manages only issues directly related to the implementation?
Seems to need to think about.
02:38 uetchy discussionへの提案は、VFMのようにそもそも提案先のリポジトリが存在しないようなアイディアが中心となります。
なので、はじめdiscussionにissueを立てて、その結果リポジトリが生まれたらそちらに移動して議論を継続するという形で良いと思います。
02:38 Kiara Translation 🇬🇧: Proposals for discussion are centered on ideas such as VFM where there is no proposed repository in the first place.
So I think it's good to start with an issue in discussion, and then move to that repository once the repository is created and continue the discussion.
02:40 akabeko はい。議論を継続する際は issue を閉じる際にそちらのリンクを貼れば分かりやすいですし、よい案だと思います。
02:40 Kiara Translation 🇬🇧: Yes. If you want to continue the discussion, put that link when closing the issue, it is easy to understand and I think it is a good idea.
02:42 uetchy 他の方から異論が無ければそのような方針で行きたいと思います!
後から議論を見た方はこのポストにスレッドを作ってコメントください
02:42 Kiara Translation 🇬🇧: If there is no objection from other people, I would like to go with such a policy!
If you see the discussion later, please create a thread on this post and comment
02:43 uetchy Markdown->HTML変換実装と、Markdownスペックを置くリポジトリの名前についてスレッドでコメントをください
現在の候補
1. vivliostyle/markdown
- 直感的でわかりやすい
- 商標権的に問題無ければ良さそう
2. vivliostyle/vfm
- 短い
- vivliostyleとvが意味的に重複している

注記: npmパッケージの名前はリポジトリ名と同期させます。
02:43 Kiara Translation 🇬🇧: Please comment on the thread about Markdown- & gt; HTML conversion implementation and the name of the repository where Markdown specifications are placed
Current suggestions
1. vivliostyle / markdown
  -Intuitive and easy to understand
  -Looks good if there is no problem with trademark right
2. vivliostyle / vfm
  -Short
  -vivliostyle and v semantically overlap

NOTE: The name of the npm package should be synchronized with the repository name.
02:47 akabeko Markdown 公式といってよいかは分かりませんが、以下を見ると Markdown 自体 (実装を指している?) ライセンスは修正 (三条項) BSD のようですね。
https://daringfireball.net/projects/markdown/license.text
02:48 Kiara Translation 🇬🇧: I don't know if it's a Markdown formula, but if you look at it below, it looks like Markdown itself (refers to the implementation?) License is modified (3 clauses) BSD.
https://daringfireball.net/projects/markdown/license.text
02:48 akabeko 商標は、そもそも誰かとっているのですかね。
02:48 Kiara Translation 🇬🇧: Do you own a trademark in the first place?
03:19 shinyu markdownの改変版なのに何もつかない “markdown” という名前にすると問題あると思います。vfmのほうがよいと思います
03:19 Kiara Translation 🇬🇧: I think there is a problem if you name it “markdown” which is a modified version of markdown but has no effect. I think vfm is better
03:27 shinyu R Markdown は参考になる?
https://kazutan.github.io/kazutanR/Rmd_intro.html
03:27 Kiara Translation 🇬🇧: Is R Markdown helpful?
https://kazutan.github.io/kazutanR/Rmd_intro.html
03:42 uetchy @shinyu @akabeko コメントありがとうございます!
GitHubもgithub/gfmで運用しているようですし、誤解される可能性もあるのでvfmで行こうと思います。
03:42 Kiara Translation 🇬🇧:   Thank you for your comment!
It seems that GitHub is also operated on github / gfm, and there is a possibility that it will be misunderstood, so I will go with vfm.
Clone this wiki locally