Some quick pieces of feedback for a newbie looking at the website

未關閉
#20 1 則留言 1 個 reaction 已指派 0 人 在 GitHub 檢視

還沒有人認領這個 Issue。

評估

難度
4/5
預估耗時
3-5 天
新手友好度
25/100
Issue 類型
功能
描述清晰度
需要釐清
活躍度
停滯
領域
content, design

研究方向

Start by reviewing the front page, navbar, and JSON-LD subpage mentioned in the feedback. The issue lists several optional suggestions but does not say which to implement; agree on a specific scope first, then consider it done when the chosen changes address that scope.

由索引模型根據 Issue 內容生成。

描述

Hey all - this looks like a really neat project!

I just took a look through the codemeta website for the first time, and just wanted to give some of my first-impressions in case they're opportunities to improve the site! I hope they don't come across as criticisms, they are meant in the spirit of constructive feedback! Feel free to disregard this entirely :-)

Some of the comments might seem a bit silly, but I tried to keep my relatively naive perspective in browsing the site, since I think that's the perspective many users would have.

  • I like how the page explains the need and motivation for code metadata, but after reading the front page I still wasn't sure what codemeta does. Maybe beginning with a short "this is what codemeta does" paragraph would be helpful.
  • The word "CrossWalk" shows up on the page, but I never saw an explanation of what this means. Maybe this is a technical word that users will already know, but it'd be helpful to explain something like "CrossWalks are a means of mapping key/values between different styles of metadata. The CodeMeta project maintains CrossWalks between a number of different metadata types (e.g. Python distutils and R DESCRIPTION files) and a common "codemeta" format.
  • The word "Terms" shows up in the navbar, but I originally didn't click on it because I assumed that it was short for "Terms and Conditions" (aka, license stuff) rather than "metadata terms". Perhaps this could be "Fields" to avoid the confusion?
  • I found the fonts a bit small to read - perhaps they could be increased in size in order to be more legible?
  • I also didn't see a link-out to an introduction to what JSON linked data is, this would be helpful for newbies that don't know what it is! edit: I found the video on the JSON-LD sub-page really helpful, perhaps it could be linked to from a "getting started" header?
主要語言
CSS
星號
5
分支
23
PR 合併指標
30 天內沒有已合併 PR

環境準備

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

codemeta/codemeta.github.io 的其他 Issue

查看 codemeta/codemeta.github.io 的全部 Issue

相似的 Issue

更多 Content Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。