feat: Add Korean translation for assembly lessons

[notJoon]

WIP

Translating the assembly lessons into Korean, with plans to translate all available documents.

Note: Converted bold text separators to proper markdown headers for better rendering

[evenharder]

I fully appreciate your endeavor for translating this marvelous material in Korean! Here are some minor comments and suggestions.

[evenharder]

In the phrase 가장 많이 사용되는 기능 중 일부, '하나' instead of '일부' seems natural.

[evenharder]

The explanation in parentheses should be moved to the former sentence to match with the original.

Also, there is an apparent typo intri은sics는.

[evenharder]

As the term immediate is a noun here, it should be represented as 즉시값.

[kiwiyou]

Typo: 오신걸 → 오신 걸

이 강의들은 FFmpeg에서 어셈블리어가 어떻게 사용되는지, 그리고 여러분들의 컴퓨터에서 실제로는 어떤 일이 일어나고 있는지 단초를 제공해줄 것입니다.

Original: These lessons will give you a grounding in the way assembly language is written in FFmpeg and open your eyes to what's actually going on in your computer.

I suggest "이 강의를 통해 여러분은 FFmpeg에서 어셈블리어 코드를 작성하는 방법의 기초를 배우고, 컴퓨터에서 실제로는 어떤 일이 일어나고 있는지에 눈뜨게 될 것입니다."

Changes:

• This text focuses on reader's gain. I feel it more natural in Korean to write in reader's active voice.
• 단초를 제공해줄 것입니다 seems like a direct translation of "give you a grounding in", but the counterpart for "open your eyes to" is missing.
• The author wrote "the way assembly language is written", not "used". This is about syntax, code styles, or rules (so "작성"), not about how FFmpeg utilizes things ("사용") written in assembly language.

[kiwiyou]

Typo: Should be 스칼라 vs 벡터, 덧셈, 곱셈 등

[kiwiyou]

FFmpeg에서 사용되는 대부분의 어셈블리 코드는 단일 명령 다중 데이터 방식인 SIMD(Single Instruction Multiple Data)로 작성되어 있습니다.
Original: The vast majority of assembly code in FFmpeg is what's known as SIMD, Single Instruction Multiple Data.

I suggest "FFmpeg에서 사용되는 대부분의 어셈블리어 코드는 SIMD(단일 명령어 다중 데이터)로 작성되어 있습니다."

"단일 명령어 다중 데이터" and "SIMD" are the same object. "단일 명령 다중 데이터 방식인 SIMD" reads as if SIMD is one of a such kind.

[kiwiyou]

Original: As you might have guessed, SIMD lends itself well to processing images, video, and audio which have lots of data ordered sequentially in memory. There are specialist instructions available in the CPU to help us process sequential data.

I suggest "짐작하셨겠지만, SIMD는 이미지, 비디오, 오디오처럼 데이터의 대부분이 메모리에 연속적으로 정렬되어 있을 때 매우 효과적입니다. CPU에는 이렇게 연속적인 데이터를 처리하는 데 특화된 명령어들이 내장되어 있습니다."

Changes:

• Images, video, and audio are mostly but not totally sequential, hence "데이터의 대부분이 ~". This change forced me to omit "processing" part, but it is implied from the context.
• "연속적" and "순차적" have both temporal and spatial meaning. Sticking to "연속적" is better since the context "메모리에서" is preserved.
• "특화" seems better since the instructions are not just special but specialized for our goal.

[kiwiyou]

Typo: 의미로 나타냅니다 → 의미입니다, assembley → assembly, also 혼재되어 사용되지만 can be just 혼용되지만

I'm not sure but if "assembly function", "SIMD", and "vector(ise)" refer to comments in FFmpeg code (not this guide) it should be written intact like "어셈블리 함수(assembly function)", "벡터(vector)", or "벡터화(vectorise)".

[kiwiyou]

Typo: 기억하는게 → 기억하는 게

어떤 것을 배우든 그 과정의 시작은 용어 익히기, 나머지 끝은 실제로 이해하기입니다.

Original: As with everything, learning is 50% jargon and 50% actual learning.

I strongly suggest "모든 것이 그렇듯이 공부의 반은 용어이고 나머지 반이 진짜 공부입니다." since this phrase is mainly emphasizing the amount of jargons.

[kiwiyou]

어셈블리어로 작성된 코드는 10배 이상의 속도 향상을 가져오는 경향이 있으며, 특히 실시간으로 끊김 없는 영상을 재생하려는 경우에 특히 중요합니다.

Original: It’s very common to get a 10x or more speed improvement from writing assembly code, which is especially important when wanting to play videos in real time without stuttering.

This is misleading. It should be "어셈블리어로 코드를 작성해서 속도를 10배 이상 향상시키는 일은 아주 흔하며, 영상을 실시간으로 끊김 없이 재생하려면 특히 중요합니다." Current translation reads as if assembly code is naturally fast, which is not.

비디오 인코딩 및 디코딩 기능은 대기업의 데이터센터를 포함한 일반 사용자 모두에게 지구상에서 가장 많이 사용되는 기능 중 하나라는 점을 강조하고 싶습니다.

Original: It’s worth pointing out that video encode and decode functions are some of the most heavily used functions on earth, both by end-users and by big companies in their datacentres.

I suggest "비디오 인코딩 및 디코딩 기능은 개인 사용자부터 대기업의 데이터센터에 이르기까지 지구상에서 가장 많이 사용되는 기능 중 하나라는 점도 중요합니다."

Changes:

• More like typo: "일반 사용자" does not contain "대기업의 데이터센터" in normal sense.
• This sentence is more like a build-up for the real point (small improvements matter) so less direct "중요합니다" feels more appropriate here?

[notJoon]

I had forgotten about “~에 이르기까지”. very good suggestion

[kiwiyou]

I suggest "인터넷에서" "웹상에서" for online (I don't think this belongs to glossary), "컴파일러 내장 함수" "(컴파일러) 인트린직" for "intrinsics". "Intrinsics" here refers only to compiler intrinsics, different from "내장 함수(normally language builtins)"

[notJoon]

"컴파일러 내장함수" seems best, but this term appears multiple times later on. I think it would be good to indicate that we'll use "인트린직" as a substitute going forward. something like "컴파일러 내장함수(이하 인트린직) ...".

For "online," "인터넷 커뮤니티에서" seems more natural. "웹상에서" feels a bit ambiguous (still better than "주변에서").

How do you think?

[kiwiyou]

또한 intrinsic은 변수에 헝가리안 표기법을 사용하고 있기 때문에 읽기 어렵다는 의견도 있습니다.

I suppose "변수에" should be omitted?

[kiwiyou]

하지만 FFmpeg과 같은 프로젝트에서는 이런 코드가 읽기 어렵고, 컴파일러에서 널리 지원되지 않으며 유지보수가 어렵다는 것이 일반적인 의견입니다.

Original: The prevailing opinion in projects like FFmpeg is that this code is hard to read, not widely supported by compilers and unmaintainable.

I strongly suggest "하지만 이런 코드는 읽기 어렵고, 여러 컴파일러에서 널리 지원하지 않으며, 유지보수가 어렵다는 것이 FFmpeg와 같은 프로젝트에서의 주된 의견입니다." The original text says that the opinion is prevailing in FFmpeg, not that the content applies to FFmpeg. I don't really understand what "projects like FFmpeg" specifically are, by the way.

[kiwiyou]

Typo: 8배 까지의 → 8배까지의 and following

[kiwiyou]

minor note: "강의" was used at the beginning

[kiwiyou]

의외로 책이나 Stack Overflow 같은 온라인 자료는 참고용으로 그다지 도움이 되지 않을 수도 있습니다.

Original: You might be surprised to hear that books or online resources like Stack Overflow are not particularly helpful as references.

I suggest "책이나 Stack Overflow 같은 온라인 자료가 참고 자료로서 특별히 유용하지는 않다고 하면 놀라실 것 같습니다." The original text is more conclusive.

[kiwiyou]

Minor note: spaces before parentheses are inconsistent.

[kiwiyou]

대부분의 어셈블리 관련 서적에서는 GPR의 세부 동작 방식이나 역사적 배경 등에 대해 지면을 할애해 다룹니다.

Original: In most assembly books, there are whole chapters dedicated to the subtleties of GPRs, the historical background etc.

This should be "대부분의 어셈블리 관련 서적에서는 GPR 사이의 차이점이나, GPR의 역사적 배경 등에 대해 지면을 할애해 다룹니다."
Subtleties, in this (historical) context, seem to be the purposes of different GPRs, e.g. rcx is used in counters.

그러나 FFmpeg에서 작성하는 대부분은 어셈블리 코드는 GPR은 보조적인 역할(scaffolding)에 가깝기 때문에 복잡한 세부 기능이 필요하지 않은 경우가 많아 대부분 추상화 되어 있습니다.

Original: In the assembly code written in FFmpeg, GPRs are more like scaffolding and most of the time their complexities are not needed and abstracted away.

Also I suggest: "FFmpeg에서 작성하는 어셈블리 코드에서 GPR은 형식적인 도구에 가깝고, 대부분의 경우 그런 복잡한 맥락은 불필요하기 때문에 추상화되어 사라집니다."

• "scaffolding" is not a jargon here. The point is: It is only important that GPRs can store values.
• I can't fully express "abstract away" in Korean but the "removal" of complexity is the point at least.

[kiwiyou]

"widely available" should be "대부분의 환경에서 사용 가능"

[kiwiyou]

Along with the following examples, it should be "16개의 바이트가 xmm 레지스터에 담긴 예시입니다."

[kiwiyou]

이번에는 간단한 (인위적이지만요) 스칼라 어셈블리 코드 조각(snippet)을 보면서 어떤 일들이 일어나는지 살펴보겠습니다.

I suggest "이번에는 인위적이지만 간단한 스칼라 어셈블리 코드를 보면서 어떤 일이 일어나는지 살펴보겠습니다."

[evenharder]

The pharse '버전' seems a little bit unnecessary here, we can just omit like "대문자로 표기하는 경우도 있지만 의미는 동일합니다."

[evenharder]

두 번째 줄은 이 함수가 SSE2 명령어 집합을 사용하여 XMM 레지스터를 초기화하도록 설정합니다.

Original: The second line shows how we are initialising the function to use XMM registers, using the sse2 instruction set.

I suggest "두 번째 줄은 SSE2 명령어 집합을 이용해 해당 함수가 XMM 레지스터를 사용하도록 설정합니다."

• The assembly initializes the function, not the XMM registers.
• For the term 'initialization, I chose '설정' as "해당 함수가 XMM 레지스터를 사용하도록 초기화합니다" seems awkward. There might be a better expression than both, though.

[evenharder]

The current sentence has a structure "벡터 레지스터는 ~이름을 사용합니다", it would be better if we refine it.

[evenharder]

Minor typo: scrq -> srcq

[evenharder]

Another minor typo: 보게될 -> 보게 될.

[evenharder]

Thank you for the hard work, here are some comments for Lesson 2.

[evenharder]

This single paragraph is already tough! Here are some suggestions

• ".loop: 뒤로 이동시킵니다": to specify the next instruction, I suggest ".loop:` 직후의 명령으로 이동시킵니다".
• 로컬 레이블: Instead of transliteration of 'local' to '로컬', how about '지역'? There are a number of examples for this direction such as 지역 변수 (local variable).

[evenharder]

Minor note: "작성합니다" is a little bit odd, we can omit as "~다음과 같습니다."

[evenharder]

The term loop is either translated to '반복문' and '루프'. Both are quite used throughout the material. As this guide is for beginners (or even, beginner programmers), I hope if we can unify both translations.

[notJoon]

That makes sense. I've revised it to translate as '반복(문)'.

[evenharder]

How about omitting "조각" (snippet) here? Or we can paraphrase to "예시 코드".

[evenharder]

주석의 내용처럼 점프 명령과 함께 읽어야 하며

Original: ..., but as per the comment, it can be read together with the jump, ...

I suggest "주석의 내용처럼 점프 명령과 같이 조합되면". as we still get the meaning where cmp can be combined with jump instructions.

[evenharder]

I suggest "어셈블리를 작성하는 이유가 C언어 반복문의 완벽한 재현이 아니라 가능한 한 빠르게 동작하는 반복문 작성임을 기억해야 합니다." My point here is that we can remove redundant ~것 here.

[evenharder]

We can remove the parentheses and make a full sentence with a period here.

[evenharder]

Minor suggestion: "이제 반복문을 작성할 수 있으니" instead of "이제 반복문을 작성할 수 있게 되었고"

[evenharder]

Minor correction: "(최대 32비트) 정수" instead of "32비트 정수" for clarity.
Original: This is an integer (up to 32-bit)

[evenharder]

This is misleading as mmsize is an alias provided by x86inc.asm. Instead of "x86 어셈블리" we should use "x86inc.asm" instead.

[notJoon]

@kiwiyou @evenharder
Thank you for the review. Translation is definitely difficult, but thanks to you, the sentences have become much more natural. I've tried to apply your suggestions as much as possible, so I'd be appreciate if you could take a look and confirm 👍