slack qa team 2020 03 18
| Time (UTC) | Icon | Name | Message |
|---|---|---|---|
| 01:43 |  |
shinyu | 私も「ドキュメント」(Documents)のままが良いと思います。このページは <http://docs.vivliostyle.org |
| 01:43 |  |
Kiara Translation | 🇬🇧: I think that "Documents" is also good. Is this page consistent with the table of contents of <http: //docs.vivliostyle.org |
| 03:07 |  |
ogwata |
「ドキュメント」という単語はプログラマにとって親しみやすいのでこの単語を使ったほうが良い、というお話だったと思います。はい、たしかにそういう経緯でした。しかしこのサイトにはプログラマ以外にも訪れてもらいたいと思っています。上記を議論した際は、この視点が抜けていたと反省しています。 より広い視点で再検討していただけませんか。 現状のページ構成の問題点は、ドキュメントとは関係ない「今後の開発予定」「コミュニティへの招待」もH1に包含していることです。 <http://docs.vivliostyle.org |
| 03:07 | |
Kiara Translation | 🇬🇧: & gt; I think the word "document" was a good idea for programmers, so it was better to use it. Yes, that was exactly the case. However, I would like this site to be visited by non-programmers. When I discussed the above, I regret that this perspective was missing. Would you reconsider from a broader perspective? The problem with the current page structure is that H1 includes "future development plans" and "community invitations" that are not related to the documentation. I understand the policy to match the table of contents at <http: //docs.vivliostyle.org |
| 03:14 | |
ogwata | 補足します。しかしこのサイトにはプログラマ以外にも訪れてもらいたいと思っています。上記を議論した際は、この視点が抜けていたと反省しています。現状の「ドキュメント」の大部分がプログラマ向けの情報であることは確かです。しかし、トップに近い「ユーザーガイド」は非開発者にも必要で、しかも非常に重要な情報です。 「「ドキュメント」という単語はプログラマにとって親しみやすい」という話しをした際、「ユーザーガイド」の部分のことが意識から抜けていたと反省しています。 |
| 03:14 | |
Kiara Translation | 🇬🇧: Supplement. & gt; But I want this site to be visited by non-programmers. When I discussed the above, I regret that this perspective was missing. Clearly, most of the current "document" is for programmers. However, a "user guide" near the top is necessary for non-developers and is very important information. When he said, "The word" document "is familiar to programmers," he recalled that the "user guide" part was out of consciousness. |
| 03:15 |  |
yamasy1549 | 感覚の問題かもしれませんが、ユーザーガイドをドキュメントと呼んでも差し支えないと思います。 |
| 03:15 | |
Kiara Translation | 🇬🇧: Perhaps it's a matter of feeling, but it's safe to call the user guide a document. |
| 03:17 | |
ogwata |
@yamasy1549 ユーザーガイドをどう呼ぶかは少し置き、H1との不一致はどのようにお考えでしょう。 |
| 03:17 | |
Kiara Translation | 🇬🇧: Let's put a little bit on how to call the user guide, and what do you think of inconsistencies with H1. |
| 03:17 |  |
uetchy | 内容の整理は必要だと思いますが、インフォメーションは耳馴染みが無いのでドキュメントの方が良いと思います |
| 03:17 | |
Kiara Translation | 🇬🇧: I think that it is necessary to organize the contents, but I think that information is not familiar to the ears, so documents are better |
| 03:19 | |
uetchy | 所見は コミュニティへの招待はドキュメントの責務では無いので移動させる リファレンスは辞書的な物でガイドでは無いのでh2で良い |
| 03:19 | |
Kiara Translation | 🇬🇧: Findings Move community invitations because they are not the responsibility of the document H2 is good because the reference is a dictionary and not a guide |
| 03:19 | |
ogwata |
内容の整理は必要だと思いますが、インフォメーションは耳馴染みが無いのでドキュメントの方が良いと思います「インフォメーション」には拘りません。たしかに耳馴染みのよいことは大事です。別案を待ちます。 重要な論点は「H1との不一致をどう考えるか」だと思っています。 |
| 03:19 | |
Kiara Translation | 🇬🇧: & gt; I think it is necessary to organize the contents, but the information is unfamiliar, so I think the document is better Regardless of "information". Certainly it is better to be familiar with the ears. Wait for another plan. I think the important issue is "How do you think of the inconsistency with H1?" |
| 03:19 | |
shinyu | Vivliostyleを技術寄りでない人々（たとえば小説を書く人）でも使えるようにと、Vivliostyle Pubプロジェクトをスタートしました。しかしそのPubでさえ、最初の段階では技術同人誌がターゲットと位置付けれれています。今の段階で Vivliostyle のWebサイトが技術寄りの人々が主な対象であることは当然だと思います。「ドキュメント」という言葉で、ソフトウェアの説明などであることが理解できる人たちがターゲットになると思います。 |
| 03:19 | |
Kiara Translation | 🇬🇧: We started the Vivliostyle Pub project to make Vivliostyle accessible to non-technical people (for example, novel writers). But even at the Pub, technical doujinshi is targeted at the beginning. At this stage, it's no surprise that the Vivliostyle website is primarily for technical people. I think the term "document" is targeted at those who can understand the description of the software. |
| 03:22 | |
uetchy | 開発予定はロードマップと改題すると収まりが良いかもしれません（任意） 別のアイデアとして、「コミュニティへの招待」を開発予定に包含させて、開発への参加を促す導線をより自然にしても良いでしょう |
| 03:22 | |
Kiara Translation | 🇬🇧: The development schedule may fit better if the title is changed to Roadmap (optional) Another idea might be to include a "community invitation" in your development schedule, making the lead that encourages participation in the development more natural |
| 03:23 | |
yamasy1549 | 開発に関する情報として開発予定（ロードマップ）やコミュニティへの招待をこのページに含めるのは問題ないと思っています |
| 03:23 | |
Kiara Translation | 🇬🇧: I think it's okay to include development plans (roadmaps) and community invitations on this page for development information |
| 03:24 | |
uetchy | ドキュメントはまとまりを持った文書を指しているので特に不一致は起きてないと思います |
| 03:24 | |
Kiara Translation | 🇬🇧: I don't think there is any inconsistency since the document points to a coherent document |
| 03:34 | |
ogwata |
今の段階で Vivliostyle のWebサイトが技術寄りの人々が主な対象であることは当然だと思います。なるほど、分かりました。当面このページを開発者にフォーカスすることに賛成します。 しかし、このページが「ドキュメント」でよいのか、まだ分かりません。 ドキュメントはまとまりを持った文書を指しているので特に不一致は起きてないと思います「今後の開発予定」の内容が、GitHubへのリンクであることからの指摘だと思います。 ドキュメントがまとまりを持った「文書」であることには同意します。それでも、GitHubとの関連はクリックをして初めて分かることで、現状はやはり問題があると思います。 クリック以前に「文書」との関連を理解分かるような工夫、たとえば見出し「今後の開発予定」の内容を工夫するべきではないでしょうか。 それがクリアされれば、H1は「ドキュメント」のままでもよいと思います。 |
| 03:34 | |
Kiara Translation | 🇬🇧: & gt; At this stage, it's no surprise that the Vivliostyle website is primarily targeted at technical people. I see. In the meantime I agree with this page being focused on developers. But I don't know yet if this page is a "document". & gt; The document points to a coherent document, so I don't think there's any inconsistency I think that the content of "future development plan" is a point because it is a link to GitHub. I agree that the document is a coherent "document". Nevertheless, the connection with GitHub can be understood only by clicking, and I think that there is still a problem at present. Shouldn't we devise a way to understand the relationship with the "document" before clicking, for example, the content of the headline? |
| 03:36 | |
yamasy1549 |
それでも、GitHubとの関連はクリックをして初めて分かることでいま「今後の開発予定」内のissueへのリンクはダミーテキストなのですが、実際は GitHub issue #12: fix ~~ みたいにするか、GitHubマークをつけようと思ってます。まだ手がつけられてなくてすみません |
| 03:36 | |
Kiara Translation | 🇬🇧: & gt; Nevertheless, the connection with GitHub is only available when you click Now, the link to the issue in "future development" is a dummy text, but in fact, I'm trying to do something like GitHub issue # 12: fix ~~ or put a GitHub mark. I'm sorry that you haven't been touched yet |
| 03:38 | |
yamasy1549 | こうすることでより、開発に関係する文書へのリンクだとわかるようになりませんか？ |
| 03:38 | |
Kiara Translation | 🇬🇧: Does this help you identify links to documentation related to development? |
| 03:40 | |
ogwata |
コミュニティへの招待はドキュメントの責務では無いので移動させるなるほど、コミュニティへの招待は既にトップページにあるので、削除でよいかも。 リファレンスは辞書的な物でガイドでは無いのでh2で良いなるほど、了解です。 |
| 03:40 | |
Kiara Translation | 🇬🇧: & gt; community invitations are not documentary responsibilities and should be moved Indeed, the invitation to the community is already on the top page, so you may delete it. & gt; Reference is lexicographic and not a guide, so h2 is fine I see. |
| 03:41 | |
yamasy1549 | すみません、かなりこんがらかってるくせに今ちょっと時間が取れないので、あとでまとめさせてください…… |
| 03:41 | |
Kiara Translation | 🇬🇧: I'm sorry, I'm pretty annoyed, but I can't take a little time now, so let me summarize later ... |
| 03:48 | |
ogwata |
開発予定はロードマップと改題すると収まりが良いかもしれません（任意）うーん、私は変えても変えなくてもどちらでもよいです。 別のアイデアとして、「コミュニティへの招待」を開発予定に包含させて、開発への参加を促す導線をより自然にしても良いでしょうなるほど、「コミュニティへの招待」をしれっとH3にしてしまうわけですね。論理的にはおかしいですが、よいアイデアだと思います。 |
| 03:48 | |
Kiara Translation | 🇬🇧: & gt; The development plan may fit better if you change the title to Roadmap (optional) Well, I can change it or not. & gt; Another idea would be to include a "community invitation" in your development schedule to make the lead that encourages participation in the development more natural Indeed, the "invitation to the community" was changed to H3. It's logically strange, but it's a good idea. |
| 03:50 | |
shinyu | コミュニティのページですが、現行サイトでは独立したページでした: https://vivliostyle.org/community/ https://vivliostyle.org/ja/community/ 新サイトでも、グローバルメニューに載せないにしても、同じURLのページがあってよいとおもいます。このURLでコミュニティの案内をしてきたし、ブックマークしている人もいるでしょう。同じURLのページを作らない場合は、その情報があるページへのリダイレクトになればよいです。 同様に、ほかのページも、なるべく現行サイトのURLが活かされるのがよいと思います。 ドキュメントは https://vivliostyle.org/docs/ など。 Vivliostyle — open source, web browser based CSS typesetting engine project Vivliostyle — open source, web browser based CSS typesetting engine project Vivliostyle — open source, web browser based CSS typesetting engine project |
| 03:50 | |
Kiara Translation | 🇬🇧: It's a community page, but it was a separate page on the current site: https://vivliostyle.org/community/ https://vivliostyle.org/ja/community/ I don't think it's okay for the new site to have a page with the same URL, even if it's not listed on the global menu. This URL has been used to guide the community and some people may have bookmarked it. If you do not create a page with the same URL, just redirect to the page with that information. Similarly, I think it is better for other pages to use the URL of the current site as much as possible. The document is https://vivliostyle.org/docs/ Such. |
| 03:52 | |
ogwata |
実際は そうか、GitHubとの関連が明示されるのなら「開発予定」のままでよいと思います。 |
| 03:52 | |
Kiara Translation | 🇬🇧: & gt; Actually, I want to do something like GitHub issue # 12: fix ~~, or put a GitHub mark.Well, if the connection with GitHub is clearly indicated, I think that it is sufficient to leave it "planned". |
| 03:55 | |
ogwata |
新サイトでも、グローバルメニューに載せないにしても、同じURLのページがあってよいとおもいます。賛成です。 私も何度かこのページのURLを示してきました。とても便利です。 |
| 03:55 | |
Kiara Translation | 🇬🇧: & gt; I think it's okay to have a page with the same URL, even if it's not on the global menu, even on the new site. agree. I have also shown the URL of this page several times. very convenient. |
| 03:59 | |
shinyu |
@yamasy1549 今後の開発予定の「Chrome拡張の作成」は、当面優先度低そうなので、のせなくてよいと思います |
| 03:59 | |
Kiara Translation | 🇬🇧: `` Chrome extension creation '' to be developed in the future seems to be low priority for the time being, so I think that it is not necessary to put it |
| 04:07 | |
ogwata | 以上の議論をまとめると、 • H1は「ドキュメント」のまま • 「ドキュメント」は開発者向けのページと位置づける • 「今後の開発予定」で、GitHubとの関連を明示 • 「コミュニティへの招待」はH2ではなく、「今後の開発予定」の下でコミュニティページへのリンク（現行のURLを変えない）にする という感じでしょうか。漏れがあればご指摘ください。 |
| 04:07 | |
Kiara Translation | 🇬🇧: To summarize the above discussion, • H1 remains "Document" • “Documents” are positioned as pages for developers • In the "future development plan", the connection with GitHub is clarified • "Community Invitation" is not H2 but a link to the community page (without changing the current URL) under "Future Development" Is it like that? Please point out any leaks. |
| 11:45 | |
yamasy1549 | 新しいサイトには About Us のページがありますが、Community ページを作るとしたらどんなコンテンツが入りますか？ 旧サイトの Community ページには、 • Slackへjoinする • Slackのログ • Facebookへのリンク（2つある？？） • Twitterへのリンク • GitHubへのリンク • 村上さんへのリンク があります コミュニティのページですが、現行サイトでは独立したページでした: |
| 12:38 | |
shinyu | Community ページの内容は、旧サイトの Community ページから村上へのリンクを削除（About Usに連絡先があるので不要）でよいと思います。 |
| 12:38 | |
Kiara Translation | 🇬🇧: For the contents of the Community page, I think that deleting the link to Murakami from the Community page of the old site (it is unnecessary because there is a contact in About Us). |
| 12:41 | |
shinyu | Facebookについては、“Vivliostyle Forum” というFacebookグループと “Vivliostyle” Facebookページがあります。 「Facebookページ vs Facebookグループ」で検索するとそれらの違いの解説記事がいろいろ出ます。次のものなど: https://hontono.co.jp/sns/difference-fbpage-and-fbgroup Facebookは、すでにユーザー数がグローバルで2017年の夏に20億人を超える、超巨大SNSとなっています。 でも、日本でのユーザー数は、2800万人（2017年9月）と正直伸び悩んでいる印象です。 これは、まだまだFacebookをやったことがない人、これからやろうとする人が日本において多い？ということの裏返しと見ることもできます。 |
| 12:41 | |
Kiara Translation | 🇬🇧: For Facebook, there is a Facebook group called “Vivliostyle Forum” and a “Vivliostyle” Facebook page. If you search for "Facebook page vs Facebook group", various commentary articles about those differences will appear. Such as: https://hontono.co.jp/sns/difference-fbpage-and-fbgroup |
| 12:47 | |
yamasy1549 |
Community ページの内容は、旧サイトの Community ページから村上へのリンクを削除（About Usに連絡先があるので不要）でよいと思います。わかりました。 About Us にある「コントリビューター一覧」を Community ページに移していいかもしれませんね。 |
| 12:47 | |
Kiara Translation | 🇬🇧: I think that the content of the & gt; Community page should delete the link to Murakami from the Community page of the old site (it is unnecessary because there is a contact in About Us). understood. You may want to move the “Contributor List” in About Us to the Community page. |
| 13:04 | |
shinyu | このAbout Usページですが、「私たちについて」のページであり、私たちとはVivliostyle Foundationとコントリビューターたちであるということで、About UsページにVivliostyle Foundationと同じレベルの見出しでコントリビューター一覧があるのでよいと思います。 ところで「dependabot[bot]」は人間でないのでコントリビューター一覧から消した方がよいと思います。 |
| 13:04 | |
Kiara Translation | 🇬🇧: This About Us page is a "About Us" page, and we are a Vivliostyle Foundation and contributor, so the About Us page has a list of contributors with the same level heading as the Vivliostyle Foundation I think it's good. By the way, "dependabot [bot]" is not a human, so I think you should delete it from the contributor list. |